std::chrono::system_clock

来自cppreference.com
< cpp‎ | chrono
 
 
 
日期和时间工具
(C++11)
(C++11)
时钟
system_clock
(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 system_clock;
(C++11 起)

std::chrono::system_clock 表示系统范围的实时壁钟。

它可以不单调:大多数系统上,系统时间可以在任何时候被调节。它是唯一有能力映射其时间点到 C 风格时间,从而能显示 (C++20 前)的 C++ 时钟。

std::chrono::system_clock 满足平凡时钟 (TrivialClock) 的要求。

不指定 system_clock 的纪元,但多数实现使用 Unix 时间(即从协调世界时 (UTC) 1970 年 1 月 1 日星期四 00:00:00 开始的时间,不计闰秒)。

(C++20 前)

system_clock 度量 Unix 时间(即从协调世界时 (UTC) 1970 年 1 月 1 日星期四 00:00:00 开始的时间,不计闰秒)。

(C++20 起)

时间点族

定义于命名空间 std::chrono
template<class Duration>
using sys_time = std::chrono::time_point<std::chrono::system_clock, Duration>;
(C++20 起)
using sys_seconds = sys_time<std::chrono::seconds>;
(C++20 起)
using sys_days = sys_time<std::chrono::days>;
(C++20 起)
进行 sys_time 上的流输出
(函数模板)
按照给定的格式从流分析 sys_time
(函数模板)
按照给定的格式输出 sys_time 到流
(函数模板)

成员类型

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

成员常量

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

成员函数

[静态]
返回表示时间中当前点的 std::chrono::time_point
(公开静态成员函数)
[静态]
转换系统时钟时间点为 std::time_t
(公开静态成员函数)
[静态]
转换 std::time_t 到系统时钟时间点
(公开静态成员函数)

参阅

决不调整的单调时钟
(类)
拥有最短可用计次周期的时间
(类)