C++如何使用std::chrono::utc_clock获取时间
C++20的std::chrono::utc_clock在GCC13.1及更高版本、Clang15及更高版本、MSVC19.34及更高版本才开始提供底层实现,但部分标准库例如macOS上的libc++仅声明该类型而未真正定义,且macOS的libc++至今仍不支持。建议改用system_clock并借助时区转换函数进行手动处理,作为跨平台可靠替代方案。
说真的,C++20 确实把 std::chrono::utc_clock 写进了标准,但想在生产环境里直接拿来用?路还长着呢。GCC 13.1+、Clang 15+ 和 MSVC 19.34+ 才刚刚开始提供底层实现,可 libstdc++ 早期的 C++20 版本经常只声明不定义,一链接就报 undefined reference to 'std::chrono::utc_clock::now()'。macOS 上的 libc++ 直到 Clang 16 都不支持,调用直接抛 std::runtime_error。所以,想用 utc_clock 之前,至少得确认三件事:编译器开了 -std=c++20、库版本达标、平台没坑。

std::chrono::utc_clock 在 C++20 才正式可用
直接用 std::chrono::utc_clock 编译会失败,除非你确认编译器支持 C++20 且启用了完整时钟支持。GCC 13+、Clang 15+ 和 MSVC 19.34+ 才开始提供该时钟的底层实现(如 __cpp_lib_chrono >= 201907L),但即使版本达标,部分标准库(如 libstdc++ 早期 C++20 实现)仍可能只声明未定义,链接时报 undefined reference to 'std::chrono::utc_clock::now()'。
- 检查是否启用 C++20:
g++ -std=c++20或clang++ -std=c++20 - 验证宏定义:
#ifdef __cpp_lib_chrono并打印其值,≥ 201907L 是必要条件 - Linux 上 libstdc++ 需要 GCC 13.1+;macOS 的 libc++ 目前(Clang 16)仍不支持
utc_clock::now(),调用会抛std::runtime_error
替代方案:用 system_clock + std::chrono::current_zone() 模拟 UTC 时间
大多数场景下,你真正需要的是“当前系统时间对应的 UTC 时间点”,而非严格符合 IERS 跳秒规则的物理 UTC。这时 std::chrono::system_clock 加时区转换更可靠:
#include#include auto now_utc = std::chrono::system_clock::now();auto utc_time_t = std::chrono::system_clock::to_time_t(now_utc);std::cout << std::put_time(std::gmtime(&utc_time_t), "%Y-%m-%d %H:%M:%S") << 'n';
std::gmtime返回 UTC 时间结构体,但它是 C 风格、非线程安全的;多线程中应改用std::gmtime_r(POSIX)或std::chrono::zoned_time{"UTC", now_utc}(C++20)- 若用
zoned_time,需确保"UTC"时区名被支持(libc++ 和较新 libstdc++ 支持,MSVC 尚不完全) - 注意:
system_clock本身不保证是 UTC,但它的 epoch 和 Unix time 一致,因此to_time_t结果天然对应 UTC 秒数
跳秒敏感场景必须用 utc_clock?现实很骨感
目前没有主流平台能提供符合 IERS 跳秒表(leap second table)的 utc_clock::now() 实现。Linux 内核不维护跳秒信息,glibc 也不暴露它;NTP 客户端(如 chrony)通常把跳秒“ smear ”进几十小时平滑处理,而非硬切。
- 如果你在写卫星轨道计算或金融高频时间戳,别依赖
utc_clock——它现在基本等于system_clock的别名(GCC 13.2 源码里就是这么定义的) - 真需要跳秒感知,得自己加载 IERS 文件(如
leap-seconds.list),配合std::chrono::tai_clock或外部库做手动校正 date::utc_clock::now()在 Howard Hinnant 的 date 库中有完整实现,但那是第三方头文件,不是标准库
编译期检测与降级 fallback 写法
不要让代码因 utc_clock 不可用而崩溃。用 constexpr if + 特征检测封装一个安全获取 UTC 时间点的函数:
#if __cpp_lib_chrono >= 201907L && defined(__GLIBCXX__) && __GNUC__ >= 13 auto t = std::chrono::utc_clock::now();#else auto t = std::chrono::system_clock::now();#endif
- 避免直接
using namespace std::chrono,否则utc_clock未定义会导致整个命名空间失效 - 跨平台项目建议统一用
std::chrono::system_clock::now()+ 显式转 UTC 字符串,比赌utc_clock的实现进度更稳妥 - Windows 上
GetSystemTimeAsFileTime()返回的是 UTC,但类型是 FILETIME,转system_clock::time_point需手动换算,不如直接用标准库
实际用的时候,先跑 std::chrono::system_clock::now(),再按需格式化为 UTC 字符串或转成 zoned_time —— 这条路径现在最稳。想靠 utc_clock 自动处理跳秒,还得再等几年。
