C++如何使用std::chrono::utc_clock获取UTC时间-C++-PHP中文网

c++oding="utf-8" ?>

std::chrono::utc_clock在c++20中才正式可用，需编译器（gcc 12+/clang 14+/msvc 19.30+）和标准库（libstdc++ gcc 13+起默认启用）双重支持，否则会报错；获取utc时间戳应使用clock_cast转system_clock再to_time_t，而非直接除以秒；c++17及更早版本应统一用std::time(nullptr)配合gmtime跨平台处理；当前所有实现均忽略闰秒，实际行为等同于system_clock。

c++如何使用std::chrono::utc_clock获取utc时间

std::chrono::utc_clock 在 C++20 中才正式可用

直接调用 std::chrono::utc_clock::now() 会编译失败，除非你确认编译器已启用 C++20 且标准库完整支持 —— GCC 12+（需 -std=c++20）、Clang 14+、MSVC 19.30+（VS 2022 17.0）才提供该时钟。更关键的是，libc++ 和 libstdc++ 的实现进度不一：libstdc++ 直到 GCC 13 才默认启用 utc_clock，而早期版本即使开了 C++20 也可能只声明未定义。

常见错误现象：error: 'utc_clock' is not a member of 'std::chrono' 或链接时 undefined reference。

检查编译选项：g++ -std=c++20 -Wall（不能用 c++17）
验证标准库支持：在代码中加 #ifdef __cpp_lib_chrono_utc 宏判断
MSVC 用户注意：需同时开启 /std:c++20 和预编译头兼容性处理，否则可能隐式降级

获取 UTC 时间戳的正确写法（C++20）

utc_clock 返回的是 utc_clock::time_point，它底层基于 system_clock，但语义上表示 UTC 时间点（不含本地时区偏移）。直接转换为秒级时间戳需经由 time_t，但注意：C++20 不保证 utc_clock::to_time_t 存在，推荐用 clock_cast 转换到 system_clock 再转。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

#include <chrono>
#include <ctime>

auto utc_now = std::chrono::utc_clock::now();
auto sys_time = std::chrono::clock_cast<:chrono::system_clock>(utc_now);
std::time_t t = std::chrono::system_clock::to_time_t(sys_time);
</:chrono::system_clock></ctime></chrono>

clock_cast 是安全的跨时钟转换机制，比手动加减 offset 更可靠
不要用 utc_now.time_since_epoch() 直接除以秒 —— 其 epoch 是 UTC 1970-01-01T00:00:00Z，但精度和表示方式依赖实现
若只需格式化输出，建议转成 sys_time 后用 std::format（C++20）或 std::put_time

替代方案：C++11/14/17 下如何可靠获取 UTC 时间

绝大多数项目仍停留在 C++17，此时 utc_clock 不可用，但 std::chrono::system_clock::now() 返回的是系统时间（通常为 UTC，尤其在 Linux/macOS；Windows 则是本地时间，受注册表 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation\RealTimeIsUniversal 控制）。

Linux/macOS：system_clock::now() 本质就是 UTC，可直接用 system_clock::to_time_t
Windows：默认是本地时间，必须显式转换 —— 先用 _gmtime64_s（MSVC）或 gmtime_r（POSIX）把 time_t 转为 tm 结构体
最便携做法：统一走 std::time(nullptr) + gmtime，再封装进 chrono::time_point

示例（跨平台）：

auto tp = std::chrono::system_clock::from_time_t(std::time(nullptr));
auto utc_tm = *std::gmtime(&std::chrono::system_clock::to_time_t(tp));

容易被忽略的时区与闰秒问题

utc_clock 名义上支持闰秒（C++20 标准要求其 time_point 可表示 TAI-UTC 偏移），但当前所有主流实现（GCC/libstdc++、Clang/libc++、MSVC）都**忽略闰秒**，实际行为等同于 system_clock。也就是说，你拿到的“UTC”时间在 1972 年后所有闰秒时刻仍是连续的 Unix 时间戳，不会停顿或跳变。