std::chrono::nonexistent_local_time

来自cppreference.com
< cpp‎ | chrono
 
 
 
日期和时间工具
(C++11)
(C++11)
时钟
(C++20)
                                                  
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
日历
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
时区
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
C 风格日期和时间
 
定义于头文件 <chrono>
class nonexistent_local_time;
(C++20 起)

定义要作为异常抛出的对象类型,以报告试图转换不存在的 std::chrono::local_timestd::chrono::sys_time 而不指定 std::chrono::choose (如 choose::earliestchoose::latest )。

std::chrono::time_zone::to_sys 和调用它的函数(例如接收 std::chrono::zoned_timestd::chrono::local_time 构造函数)抛出此异常。

cpp/error/exceptioncpp/error/runtime errorstd-chrono-nonexistent local time-inheritance.svg

继承图

成员函数

(构造函数)
构造异常对象
(公开成员函数)

std::chrono::nonexistent_local_time::nonexistent_local_time

template< class Duration >

nonexistent_local_time(const std::chrono::local_time<Duration>& tp,

                       const std::chrono::local_info& i);

构造异常对象。 what() 所返回的解释字符串等价于下列代码后 os.str() 所产生者:

std::ostringstream os;
os << tp << " is in a gap between\n"
   << std::chrono::local_seconds(i.first.end.time_since_epoch()) + i.first.offset 
   << ' ' << i.first.abbrev << " and\n"
   << std::chrono::local_seconds(i.second.begin.time_since_epoch()) + i.second.offset
   << ' ' << i.second.abbrev
   << " which are both equivalent to\n"
   << i.first.end << " UTC";

因为不容许复制派生自 std::exception 的标准库类抛出异常,此信息通常在内部存储为分离分配的引用计数字符串。

i.result != std::chrono::local_info::nonexistent 则行为未定义。

参数

tp - 试图转换的时间点
i - 描述转换尝试的结果的 std::chrono::local_info

异常

可能抛出 std::bad_alloc