system_clock 结构

基于系统实时时钟的时钟。

语法

struct system_clock;

备注

此时钟表示系统范围的时钟。

system_clock 不是单调时钟也不是稳定时钟。

如果首次调用 now() 返回的值始终小于或等于后续调用 now() 返回的值,则为单调时钟。 system_clock 不是单调时钟,因为系统时间可能会在调用 now() 期间进行调整。

如果它是单调时钟并且时钟计时周期之间的时间是常量,则为稳定时钟。 尽管时钟计时周期之间的时间是常量,但由于 system_clock 不是单调时钟,所以它并不稳定。 只能使用稳定时钟获取事件之前的时间、事件之后的时间,以及使它们可靠地相减以获取事件的持续时间,因为在该时段内不会调整稳定时钟。

成员

便利类型别名

名称 描述
system_clock::duration 在 Microsoft 的实现中,它是 duration<long long, ratio<1, 10'000'000> 的同义词。 它表示以 100 纳秒为单位测量的持续时间。
system_clock::period 在 Microsoft 的实现中,它是 ratio<1, 10'000'000> 的同义词。 以秒的分数(100 纳秒)为单位表示持续时间中每个时钟周期的时间。
system_clock::rep long long 的同义词。 它是用来表示此时钟的 system_clock::duration 中的整数单位的类型。
system_clock::time_point time_point<system_clock> 的同义词。 表示此时钟的 time_point

相关

名称 描述
sys_days using sys_days = sys_time<days> 的同义词。 天数计数,由与 system_clock 关联的 time_point 表示。 在 std::chrono 中定义
sys_seconds using sys_seconds = sys_time<seconds> 的同义词。 秒计数,由与 system_clock 关联的 time_point 表示。 在 std::chrono 中定义
sys_time template <class Duration> using sys_time = time_point<system_clock, Duration> 的同义词。 表示 system_clocktime_point。 指定持续时间。 在 std::chrono 中定义。

公共方法

名称 描述
from_time_t 静态。 返回最接近指定 time_tsystem_clocktime_point
now 静态。 返回当前 时间。
to_time_t 静态。 返回最接近指定 time_pointtime_t 对象。

公共常数

“属性” 描述
system_clock::is_steady 指示时钟类型是否为稳定。 这是 false

要求

标头<chrono>

命名空间std::chrono

from_time_t

返回 time_point 的静态方法,此返回值最接近 Tm 表示的时间。

static time_point from_time_t(time_t Tm) noexcept;

参数

Tm
一个 time_t 对象。

is_steady

指定时钟类型是否为稳定的静态值。 由于 system_clock 不稳定,因此不能使用此时钟获取事件之前的时间、事件之后的时间,以及使它们可靠地相减以获取事件的持续时间,因为在该计时间隔内时钟可能会调整。

static const bool is_steady = false;

返回值

在此实现中,system_clock::is_steady 始终返回 false

注解

如果它是单调时钟并且时钟计时周期之间的时间是常量,则为稳定时钟。 system_clock 不是单调时钟,因为第一次调用 now() 返回的值并不总是小于或等于后续调用 now() 返回的值,因为系统时间可以在不通知的情况下进行调整。

now

返回系统的当前时钟时间的静态方法。

static time_point now() noexcept;

返回值

表示当前时间的 time_point

to_time_t

返回 time_t 的静态方法,该返回值最接近 Time 表示的时间。

static time_t to_time_t(const time_point& Time) noexcept;

参数

Time
time_point 对象。

另请参阅

<chrono>
file_clock class
high_resolution_clock
steady_clock 结构
tai_clock
utc_clock
头文件引用