std::system_clock::now()返回的是自纪元起的time_point(如纳秒计数),非可读日历时间;必须经to_time_t()转为time_t,再用localtime_r()/localtime_s()解析为tm,最后strftime格式化输出。

直接用 std::system_clock 获取日历时间,核心就两步:获取当前时间点(time_point),再转换为 std::time_t 用于格式化。它不是“系统时钟类”,而是标准库定义的、与系统实时时钟对齐的时钟类型。
为什么不能直接用 std::system_clock::now() 当作年月日?
std::system_clock::now() 返回的是一个 time_point,本质是自纪元起的某个时长(比如纳秒或微秒),不是可读的年月日。必须通过 std::system_clock::to_time_t() 转成 std::time_t,才能交给 std::localtime() 或 std::gmtime() 解析。
常见错误现象:
- 直接打印
std::system_clock::now()—— 输出一堆无意义的数字(内部计数值) - 忘记调用
to_time_t()就传给localtime()—— 编译失败,类型不匹配 - 用
std::chrono::system_clock::to_time_t()时传入了错误类型的time_point(比如用了steady_clock的结果)—— 编译报错或未定义行为
获取本地时间(年月日时分秒)的标准流程
这是最常用场景:输出当前本地时间字符串。关键在于顺序不能乱,且注意线程安全(std::localtime 返回静态缓冲区指针)。
立即学习“C++免费学习笔记(深入)”;
- 调用
std::chrono::system_clock::now()获取当前时间点 - 用
std::chrono::system_clock::to_time_t()转为std::time_t - 用
std::localtime()(或std::localtime_r()在 POSIX 系统上)转为std::tm - 用
std::strftime()格式化输出,避免直接操作tm成员(易出错)
auto now = std::chrono::system_clock::now();
std::time_t t = std::chrono::system_clock::to_time_t(now);
std::tm tm_buf;
#ifdef _WIN32
localtime_s(&tm_buf, &t);
#else
localtime_r(&t, &tm_buf); // POSIX
#endif
char buf[64];
std::strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", &tm_buf);
std::cout << buf << '\n';
获取 UTC 时间(避免时区干扰)
如果需要跨时区一致的时间表示(如日志时间戳、网络协议时间),应使用 std::gmtime() 替代 std::localtime()。两者输入都是 std::time_t,区别只在是否应用本地时区偏移。
-
std::gmtime()是 UTC,std::localtime()是本地时区(受TZ环境变量影响) - Windows 下对应函数是
gmtime_s(),POSIX 下是gmtime_r() -
std::time_t本身是 UTC 秒数,只是解析方式不同 —— 这点容易被误解
auto now = std::chrono::system_clock::now();
std::time_t t = std::chrono::system_clock::to_time_t(now);
std::tm tm_buf;
#ifdef _WIN32
gmtime_s(&tm_buf, &t);
#else
gmtime_r(&t, &tm_buf);
#endif
char buf[64];
std::strftime(buf, sizeof(buf), "%Y-%m-%dT%H:%M:%SZ", &tm_buf);
std::cout << buf << '\n'; // ISO 8601 UTC 格式
精度与可移植性注意事项
std::system_clock 的精度和纪元起点由实现定义,但 C++11 起要求其 time_point 必须能转为 std::time_t,且该转换需保持单调性和大致同步于系统实时时钟。
- Windows MSVC:通常基于
GetSystemTimeAsFileTime(),精度约 100ns,纪元为 1601-01-01 - Linux GCC:通常基于
clock_gettime(CLOCK_REALTIME),精度可达纳秒级,纪元为 1970-01-01 - 不要假设
system_clock::duration是微秒或纳秒 —— 用auto或decltype推导 - 跨平台代码中,避免依赖
system_clock::period::num/den做手动换算
真正容易被忽略的是:即使你只想要秒级时间,也必须走 to_time_t → gmtime_r 这条路径,而不是试图从 time_point 中直接除以某个固定值 —— 因为不同平台的底层计时单位和纪元都不同。











