c++oding="utf-8" ?>
std::chrono::leap_second 不是标准 c++ 的一部分,c++20 和 c++23 中均不存在该类型;标准库仅通过 utc_clock 等时钟自动处理闰秒,不提供查询接口,历史闰秒数据需依赖 iers 的 leap-seconds.list 文件手动解析。

std::chrono::leap_second 在 C++20 中并不存在
直接说结论:std::chrono::leap_second 不是标准 C++ 的一部分,C++20 和 C++23 标准中**根本没有这个类型或函数**。你在网上看到的类似名称,大概率是误传、文档笔误,或是某个实验性库(比如某些 chrono 扩展提案草案)里的占位符名。
标准 <chrono></chrono> 提供的是 std::chrono::utc_clock、std::chrono::tai_clock 等带闰秒语义的时钟,但它们**不提供查询历史闰秒列表的接口**——标准库只负责“在需要时自动应用闰秒偏移”,不暴露闰秒发生时间点。
想获取历史闰秒列表?得靠外部数据源
闰秒由 IERS(国际地球自转服务)发布,官方以公告(Bulletin C)形式按需更新,目前(截至 2024 年)共 27 次正闰秒(无负闰秒),最后一次是 2016 年 12 月 31 日。C++ 标准库不内置该列表,必须手动集成。
常见做法:
- 硬编码一份已知闰秒表(适用于嵌入式或离线场景),例如用
std::vector<:chrono::sys_seconds></:chrono::sys_seconds>存储每个闰秒生效的 UTC 时间点(如sys_seconds{1483228800s}对应 2016-12-31T23:59:60Z) - 加载 IERS 官方发布的
leap-seconds.list文件(纯文本格式,含注释、过期时间戳和 TAI-UTC 差值),解析后构建映射 - 调用系统级 API(如 Linux 的
clock_gettime(CLOCK_TAI, ...))间接感知偏移,但无法回溯历史
std::chrono::utc_clock 只能“用”闰秒,不能“查”闰秒
std::chrono::utc_clock 是 C++20 引入的、语义上遵循 UTC 定义的时钟(即包含闰秒),但它设计目标是“正确转换时间点”,不是“提供闰秒元数据”。它的 to_sys() 和 from_sys() 静态成员函数会自动处理闰秒偏移,但不会告诉你“哪一秒是闰秒”。
示例:以下代码能获得当前 UTC 时间对应的系统时间(即 Unix time),但无法从中反推出闰秒事件:
auto utc_now = std::chrono::utc_clock::now(); auto sys_now = std::chrono::utc_clock::to_sys(utc_now); // 自动扣除当前 TAI-UTC 偏移
注意:utc_clock::now() 返回的是“UTC 时间点”,它内部可能基于系统 TAI 或模拟逻辑实现;不同标准库实现(libstdc++、libc++)对闰秒的支持程度和精度也不同,部分实现甚至仍为 stub(返回 sys_time 而不做修正)。
真正可用的闰秒查询方案:推荐轻量解析 leap-seconds.list
IERS 官网(https://hpiers.obspm.fr/iers/bul/bulc/ntp/leap-seconds.list)维护的 leap-seconds.list 是事实标准。文件每行格式为:
#@ 0x7F0D9E4000000000 # expiration timestamp (TAI) # $Header: /home/twincam/CVSROOT/ntp/ntpd/leap-seconds.list,v 1.57 2023/06/21 13:13:44 albertel Exp $ 2272060800 10 # POSIX time + TAI-UTC offset (e.g., 1972-01-01T00:00:00Z → TAI = UTC + 10s)
关键点:
- 第一列是 POSIX 时间(即
sys_seconds的 count),表示该闰秒**生效时刻的 UTC 时间**(注意:不是插入位置,而是该秒结束时插入闰秒) - 第二列是当时的 TAI-UTC 差值(单位:秒),每次增加 1 表示新增一次正闰秒
- 需跳过以
#开头的注释行,并校验文件末尾的 expiration 时间(避免使用过期数据) - 解析后可构建
std::map<:chrono::sys_seconds int></:chrono::sys_seconds>,键为闰秒发生时刻,值为累计偏移
这一步没有标准库替代方案,必须自己写解析逻辑或引入第三方(如 Howard Hinnant 的 date 库提供了 parse_leap_seconds() 辅助函数,但仍是外部依赖)。
真正的难点不在 C++ 语法,而在数据时效性、文件加载路径、跨平台换行符和 expiration 校验——这些细节容易被忽略,但直接影响闰秒计算是否准确。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











