std::chrono::nonexistent_local_time

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

日期和时间库

时间点 时间点 (time_point) (C++11) 时钟时间转换 (clock_time_conversion) (C++20)   时钟转换 (clock_cast) (C++20) 时长 持续时间 (duration) (C++11) 时钟 系统时钟 (system_clock) (C++11) 稳态时钟 (steady_clock) (C++11) 是时钟 (is_clock) (C++20) UTC时钟 (utc_clock) (C++20) TAI时钟 (tai_clock) (C++20) 高精度时钟 (high_resolution_clock) (C++11) GPS时钟 (gps_clock) (C++20) 文件时钟 (file_clock) (C++20) 本地时间 (local_t) (C++20) 日间时间 是上午 (is_am)是下午 (is_pm) (C++20)(C++20) 生成12小时制 (make12)生成24小时制 (make24) (C++20)(C++20) 时分秒 (hh_mm_ss) (C++20)

日历 日 (day) (C++20) 月 (month) (C++20) 年 (year) (C++20) 星期 (weekday) (C++20) 运算符/ (operator/) (C++20) 年月日 (year_month_day) (C++20) 年月日_最后 (year_month_day_last) (C++20) 年月星期 (year_month_weekday) (C++20) 年月星期_最后 (year_month_weekday_last) (C++20)   带索引的星期 (weekday_indexed) (C++20) 最后一个星期 (weekday_last) (C++20) 月日 (month_day) (C++20) 月日_最后 (month_day_last) (C++20) 月星期 (month_weekday) (C++20) 月星期_最后 (month_weekday_last) (C++20) 年月 (year_month) (C++20) 最后指定 (last_spec)最后 (last) (C++20)(C++20) chrono I/O 解析 (parse) (C++20)

时区 时区数据库 (tzdb) (C++20) 时区数据库列表 (tzdb_list) (C++20) 获取时区数据库 (get_tzdb)获取时区数据库列表 (get_tzdb_list)重新加载时区数据库 (reload_tzdb)远程版本 (remote_version) (C++20)(C++20)(C++20)(C++20) 系统信息 (sys_info) (C++20) 本地信息 (local_info) (C++20) 不存在的本地时间 (nonexistent_local_time) (C++20) 模棱两可的本地时间 (ambiguous_local_time) (C++20) 定位时区 (locate_zone) (C++20) 当前时区 (current_zone) (C++20) 时区 (time_zone) (C++20) 选择 (choose) (C++20) 带时区的特性 (zoned_traits) (C++20) 带时区的时间 (zoned_time) (C++20) 时区链接 (time_zone_link) (C++20) 闰秒 (leap_second) (C++20) 闰秒信息 (leap_second_info) (C++20) 获取闰秒信息 (get_leap_second_info) (C++20) C风格日期和时间

 

定义于头文件 <chrono>
class nonexistent_local_time;		(C++20 起)

定义一种对象类型，当尝试将不存在的 std::chrono::local_time 转换为 std::chrono::sys_time 而未指定 std::chrono::choose (例如 choose::earliest 或 choose::latest) 时，作为异常抛出。

此异常由 std::chrono::time_zone::to_sys 以及调用它的函数（例如接受 std::chrono::local_time 的 std::chrono::zoned_time 的构造函数）抛出。

继承图

成员函数

(构造函数)	构造异常对象 (公开成员函数)
运算符= (operator=)	替换异常对象 (公开成员函数)
what	返回解释字符串 (公开成员函数)

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 );	(1)	(C++20 起)
nonexistent_local_time( const nonexistent_local_time& other ) noexcept;	(2)	(C++20 起)

构造异常对象。

1) 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";

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

2) 拷贝构造函数。如果 *this 和 other 都具有动态类型 std::chrono::nonexistent_local_time，则 std::strcmp(what(), other.what()) == 0。

参数

tp	-	尝试转换的时间点
i	-	描述转换尝试结果的 std::chrono::local_info
其他	-	另一个 nonexistent_local_time 对象，用于拷贝

异常

可能抛出 std::bad_alloc

注意

由于拷贝标准库中派生自 std::exception 的类不允许抛出异常，因此此消息通常在内部存储为单独分配的引用计数字符串。

std::chrono::nonexistent_locale_time::operator=

nonexistent_locale_time& operator=( const nonexistent_locale_time& other ) noexcept;		(C++20 起)

将内容赋值为 other 的内容。如果 *this 和 other 都具有动态类型 std::chrono::nonexistent_locale_time，则赋值后 std::strcmp(what(), other.what()) == 0。

参数

其他

-

用于赋值的另一个异常对象

返回值

*this

std::chrono::nonexistent_locale_time::what

virtual const char* what() const noexcept;		(C++20 起)

返回解释字符串。

返回值

指向一个实现定义的以空字符结尾的字符串，其中包含解释性信息。该字符串适合转换为 std::wstring 并显示。该指针保证在获取它的异常对象被销毁之前，或在异常对象上的非 const 成员函数（例如拷贝赋值运算符）被调用之前有效。

在常量求值期间，返回的字符串使用普通字面量编码进行编码。

(C++26 起)

注意

允许但不要求实现重写 what()。

继承自 std::runtime_error

继承自 std::exception

成员函数

(析构函数) [虚函数]	销毁异常对象 (std::exception 的虚公共成员函数)
what [虚函数]	返回解释字符串 (std::exception 的虚公共成员函数)

参阅

模棱两可的本地时间 (ambiguous_local_time) (C++20)

报告本地时间模糊时抛出的异常 (类)