std::chrono::tai_clock

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

输入/输出库

本地化库

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

文件系统库 (C++17)

技术规范

 

日期和时间工具

duration (C++11) time_point (C++11) time_of_day (C++20)	clock_time_conversion (C++20) clock_cast (C++20)
时钟
system_clock (C++11) steady_clock (C++11) high_resolution_clock (C++11) is_clock (C++20)	utc_clock (C++20) tai_clock (C++20) gps_clock (C++20) file_clock (C++20) local_t (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)
时区
tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20)	time_zone (C++20) locate_zone (C++20) current_zone (C++20) zoned_time (C++20) link (C++20) leap (C++20)
C 风格日期和时间

 

std::chrono::tai_clock

成员函数

tai_clock::now

tai_clock::to_utc

tai_clock::from_utc

时间点 I/O

operator<<

to_stream

from_stream

 

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

时钟 std::chrono::tai_clock 是表示国际原子时 (International Atomic Time, TAI) 概念的时钟 (Clock) 。它度量从 1958 年 1 月 1 日 00:00:00 开始的时间，并且在当天提前 UTC 10 秒（即其纪元 1958-01-01 00:00:00 TAI 是 1957-12-31 23:59:50 UTC ）。

不插入闰秒到 TAI 中。从而每次插入一闰秒到 UTC 中， UTC 就多落后 TAI 一秒。迄至 2017 年 12 月， UTC 比 TAI 落后 37 秒，反映了 10 秒的初始差距和 1958 到 2017 年间插入的 27 闰秒。从而 2018-01-01 00:00:00 UTC 等价于 2018-01-01 00:00:37 TAI 。

tai_clock 满足时钟 (Clock) 要求。它不满足平凡时钟 (TrivialClock) 要求，除非实现能保证 now() 不抛异常。

时间点族

定义于命名空间 std::chrono
template<class Duration> using tai_time = std::chrono::time_point<std::chrono::tai_clock, Duration>;		(C++20 起)
using tai_seconds = tai_time<std::chrono::seconds>;		(C++20 起)

operator<<(std::chrono::tai_time) (C++20)	进行 tai_time 上的流输出 (函数模板)
from_stream(std::chrono::tai_time) (C++20)	按照给定的格式从流分析 tai_time (函数模板)
to_stream(std::chrono::tai_time) (C++20)	按照给定的格式输出 tai_time 到流 (函数模板)

成员类型

成员类型	定义
rep	表示时钟时长中计次数的有符号算术类型
period	表示时钟计次周期的 std::ratio 类型，单位为秒
duration	std::chrono::duration<rep, period> ，足以表示负时长
time_point	std::chrono::time_point<std::chrono::tai_clock>

成员常量

constexpr bool is_steady [静态]

若时间间隔计次始终为常数，即纵使在调整了外部时钟的情况下，调用 now() 的返回值亦单调递增，则为 true ；否则为 false (公开静态成员常量)

成员函数

now [静态]	返回表示当前时间点的 std::chrono::time_point (公开静态成员函数)
to_utc [静态]	转换 tai_time 为 utc_time (公开静态成员函数)
from_utc [静态]	从 utc_time 转换到 tai_time (公开静态成员函数)