日历与时区库(Calendar and Timezone) ​

什么是日历与时区库 ​

C++20 对 <chrono> 库进行了大规模扩展,新增了日历(Calendar)和时区(Time Zone)两大功能模块。在此之前,C++ 标准库中的时间处理仅限于时间点(time_point)和时间段(duration)——你可以精确计量一段时间有多长,但没有"2024年3月15日"或"东京时区"这样的概念。

C++20 的扩展让你可以直接在代码中操作年、月、日、星期几等日历概念,也可以处理不同时区的时间转换,而且完全基于 IANA 时区数据库(全球时区标准数据源)。

头文件 ​

cpp
#include <chrono>

所有新增内容都在 std::chrono 命名空间中。

核心日历类型 ​

类型说明
std::chrono::year年份(如 2024y)
std::chrono::month月份(January 到 December)
std::chrono::day日(1d 到 31d)
std::chrono::weekday星期几(Sunday 到 Saturday)
std::chrono::year_month_day完整日期(年-月-日)
std::chrono::year_month_day_last某年某月的最后一天
std::chrono::year_month_weekday某年某月的第 N 个星期几
std::chrono::sys_days系统时钟的天精度时间点
std::chrono::local_days本地时间的天精度时间点
std::chrono::hh_mm_ss时:分:秒(把 duration 拆分为时分秒)

核心时区类型 ​

类型说明
std::chrono::time_zone时区对象
std::chrono::zoned_time时区 + 时间点的组合
std::chrono::current_zone()获取当前系统时区
std::chrono::locate_zone("名称")按名称查找时区

基本示例 ​

cpp
#include <iostream>
#include <chrono>
#include <format>

using namespace std::chrono;
using namespace std::chrono_literals;

// ============================
// 示例1:创建和操作日期
// ============================

void calendar_basics() {
    // 使用 operator/ 创建日期(非常直观的语法)
    auto date1 = 2024y / March / 15;            // year/month/day
    auto date2 = March / 15 / 2024;             // month/day/year(美式写法)
    auto date3 = 15d / March / 2024;            // day/month/year(欧式写法)

    // 使用构造函数创建
    year_month_day ymd{year{2024}, month{3}, day{15}};

    // 检查日期是否有效
    std::cout << "2024/2/29 有效: " << std::boolalpha
              << (2024y / February / 29).ok() << std::endl;  // true(闰年)
    std::cout << "2023/2/29 有效: "
              << (2023y / February / 29).ok() << std::endl;  // false

    // 获取年月日各分量
    year_month_day today = 2024y / March / 15;
    std::cout << "年: " << static_cast<int>(today.year()) << std::endl;
    std::cout << "月: " << static_cast<unsigned>(today.month()) << std::endl;
    std::cout << "日: " << static_cast<unsigned>(today.day()) << std::endl;
}

// ============================
// 示例2:日期运算
// ============================

void date_arithmetic() {
    auto date = 2024y / March / 15;

    // 加减月份
    auto next_month = date + months{1};    // 2024/4/15
    auto prev_month = date - months{1};    // 2024/2/15

    // 加减年份
    auto next_year = date.year() + years{1} / date.month() / date.day();  // 2025/3/15

    // 通过 sys_days 进行天数运算
    sys_days sd = sys_days{date};
    auto plus_10_days = year_month_day{sd + days{10}};    // 2024/3/25
    auto minus_5_days = year_month_day{sd - days{5}};     // 2024/3/10

    // 计算两个日期之间的天数
    auto date1 = sys_days{2024y / January / 1};
    auto date2 = sys_days{2024y / December / 31};
    auto diff = date2 - date1;
    std::cout << "2024年共 " << diff.count() << " 天" << std::endl;  // 365(闰年366-1)

    // 获取某月最后一天
    auto last_feb = 2024y / February / last;  // year_month_day_last
    year_month_day last_day = last_feb;
    std::cout << "2024年2月最后一天: " << static_cast<unsigned>(last_day.day()) << std::endl;  // 29
}

// ============================
// 示例3:星期几
// ============================

void weekday_demo() {
    // 从日期获取星期几
    auto date = 2024y / March / 15;
    weekday wd{sys_days{date}};

    // weekday 的值:Sunday=0, Monday=1, ..., Saturday=6
    std::cout << "2024/3/15 是星期" << wd.c_encoding() << std::endl;

    // 使用预定义常量
    if (wd == Friday) {
        std::cout << "是星期五!" << std::endl;
    }

    // 某月的第 N 个星期几
    // 2024年3月的第一个星期一
    auto first_monday = 2024y / March / Monday[1];
    year_month_day fmd = first_monday;
    std::cout << "第一个星期一: " << static_cast<unsigned>(fmd.day()) << "日" << std::endl;

    // 某月最后一个星期五
    auto last_friday = 2024y / March / Friday[last];
    year_month_day lfd = last_friday;
    std::cout << "最后一个星期五: " << static_cast<unsigned>(lfd.day()) << "日" << std::endl;
}

// ============================
// 示例4:时分秒拆分
// ============================

void time_of_day_demo() {
    // 用 hh_mm_ss 把一个 duration 拆分为时、分、秒
    auto dur = 10h + 35min + 17s;
    hh_mm_ss tod{dur};

    std::cout << "时: " << tod.hours().count() << std::endl;
    std::cout << "分: " << tod.minutes().count() << std::endl;
    std::cout << "秒: " << tod.seconds().count() << std::endl;

    // 带小数秒
    auto precise = 3h + 25min + 45s + 123ms;
    hh_mm_ss<std::chrono::milliseconds> precise_tod{precise};
    std::cout << "亚秒部分: " << precise_tod.subseconds().count() << " ms" << std::endl;
}

// ============================
// 示例5:时区操作
// ============================

void timezone_demo() {
    // 获取当前系统时区
    const auto* local_tz = current_zone();
    std::cout << "当前时区: " << local_tz->name() << std::endl;

    // 获取当前 UTC 时间
    auto now = system_clock::now();

    // 创建带时区的时间
    zoned_time local_time{current_zone(), now};
    std::cout << "本地时间: " << local_time << std::endl;

    // 查看不同时区的时间
    zoned_time tokyo_time{"Asia/Tokyo", now};
    zoned_time ny_time{"America/New_York", now};
    zoned_time london_time{"Europe/London", now};

    std::cout << "东京: " << tokyo_time << std::endl;
    std::cout << "纽约: " << ny_time << std::endl;
    std::cout << "伦敦: " << london_time << std::endl;

    // 时区转换
    auto utc_time = sys_days{2024y / July / 4} + 12h;  // UTC 2024-07-04 12:00
    zoned_time utc{"UTC", utc_time};
    zoned_time shanghai{"Asia/Shanghai", utc_time};

    std::cout << "UTC:  " << utc << std::endl;
    std::cout << "上海: " << shanghai << std::endl;
}

int main() {
    std::cout << "=== 日历基础 ===" << std::endl;
    calendar_basics();

    std::cout << "\n=== 日期运算 ===" << std::endl;
    date_arithmetic();

    std::cout << "\n=== 星期几 ===" << std::endl;
    weekday_demo();

    std::cout << "\n=== 时分秒 ===" << std::endl;
    time_of_day_demo();

    std::cout << "\n=== 时区 ===" << std::endl;
    timezone_demo();

    return 0;
}

日期创建语法汇总 ​

C++20 用重载的 operator/ 提供了三种直观的日期创建方式:

语法风格写法说明
年/月/日2024y / March / 15ISO 风格
月/日/年March / 15 / 2024美式风格
日/月/年15d / March / 2024欧式风格

注意第一个操作数的类型决定了解析方式:year 开头 -> 年/月/日,month 开头 -> 月/日/年,day 开头 -> 日/月/年。

新增时钟类型 ​

时钟说明
system_clock系统时钟(C++11,C++20 起定义为 UTC)
utc_clockUTC 时钟,包含闰秒
tai_clock国际原子时
gps_clockGPS 时间
file_clock文件系统时间戳使用的时钟

适用场景 ​

  • 日历计算:工作日计算、账单到期日、假期排期等
  • 时区处理:跨国应用的时间显示和转换
  • 日志系统:精确记录不同时区的事件时间
  • 调度系统:计划任务的时间计算
  • 金融系统:交易时间在不同交易所时区的转换

常见问题 ​

year_month_day 和 sys_days 有什么区别?

year_month_day 是"日历表示"(年-月-日三个字段),方便人类阅读。sys_days 是"时间点表示"(从 1970-01-01 起的天数),方便做算术运算。两者之间可以自由转换。做日期加减天数时要先转成 sys_days,拿到年月日分量时要用 year_month_day。

时区数据库从哪来的?

C++20 的时区功能基于 IANA 时区数据库(也叫 Olson 数据库)。编译器/标准库需要包含这个数据库。MSVC 自带了,GCC/libstdc++ 需要安装 tzdata 包。

如何获取"今天"的日期?

cpp
auto today = year_month_day{floor<days>(system_clock::now())};

floor<days> 把当前时间截断到天精度,再转为 year_month_day。

创建了无效日期(如 2023/2/29)会怎样?

不会报错或抛异常,但 .ok() 方法返回 false。转成 sys_days 时行为是未定义的。使用前应该检查 .ok()。

注意事项 ​

  • 日期运算中加减月份可能产生无效日期(如 1月31日加一个月变成2月31日),需要用 .ok() 检查
  • 时区功能依赖 IANA 时区数据库,部分编译器/平台可能需要额外安装
  • sys_days 和 local_days 是不同的类型——sys_days 是 UTC 天数,local_days 是本地天数
  • year 的范围是 -32767 到 32767
  • 月份和日期的字面量后缀不同:年用 y(如 2024y),日用 d(如 15d),月份用预定义常量(如 March)
  • zoned_time 的构造可能因为时区数据库问题抛出异常

编译器支持情况 ​

特性GCCClangMSVC
日历类型11.014.0(部分)19.29 (VS 2019 16.10)
时区支持11.0(需要 libstdc++ tzdata)19.0(libc++,部分)19.29 (VS 2019 16.10)
std::format 时间格式化13.017.019.29

总结 ​

C++20 的日历与时区库是对 <chrono> 的一次重大扩展。日历部分让你可以直接操作年、月、日、星期几等概念,用直观的 operator/ 语法创建日期(2024y / March / 15),做日期加减、查询某月最后一天、获取某月第 N 个星期几等操作。时区部分基于 IANA 时区数据库,提供了 zoned_time 来表示带时区的时间,可以方便地在不同时区之间转换。整个库的设计风格和 C++11 的 chrono 一脉相承——类型安全、零开销抽象、编译期可计算。对于需要处理日期和时区的应用,这是一个功能完备的标准库解决方案,不再需要依赖第三方库。