日历与时区库(Calendar and Timezone)
什么是日历与时区库
C++20 对 <chrono> 库进行了大规模扩展,新增了日历(Calendar)和时区(Time Zone)两大功能模块。在此之前,C++ 标准库中的时间处理仅限于时间点(time_point)和时间段(duration)——你可以精确计量一段时间有多长,但没有"2024年3月15日"或"东京时区"这样的概念。
C++20 的扩展让你可以直接在代码中操作年、月、日、星期几等日历概念,也可以处理不同时区的时间转换,而且完全基于 IANA 时区数据库(全球时区标准数据源)。
头文件
#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("名称") | 按名称查找时区 |
基本示例
#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 / 15 | ISO 风格 |
| 月/日/年 | March / 15 / 2024 | 美式风格 |
| 日/月/年 | 15d / March / 2024 | 欧式风格 |
注意第一个操作数的类型决定了解析方式:year 开头 -> 年/月/日,month 开头 -> 月/日/年,day 开头 -> 日/月/年。
新增时钟类型
| 时钟 | 说明 |
|---|---|
system_clock | 系统时钟(C++11,C++20 起定义为 UTC) |
utc_clock | UTC 时钟,包含闰秒 |
tai_clock | 国际原子时 |
gps_clock | GPS 时间 |
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 包。
如何获取"今天"的日期?
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的构造可能因为时区数据库问题抛出异常
编译器支持情况
| 特性 | GCC | Clang | MSVC |
|---|---|---|---|
| 日历类型 | 11.0 | 14.0(部分) | 19.29 (VS 2019 16.10) |
| 时区支持 | 11.0(需要 libstdc++ tzdata) | 19.0(libc++,部分) | 19.29 (VS 2019 16.10) |
std::format 时间格式化 | 13.0 | 17.0 | 19.29 |
总结
C++20 的日历与时区库是对 <chrono> 的一次重大扩展。日历部分让你可以直接操作年、月、日、星期几等概念,用直观的 operator/ 语法创建日期(2024y / March / 15),做日期加减、查询某月最后一天、获取某月第 N 个星期几等操作。时区部分基于 IANA 时区数据库,提供了 zoned_time 来表示带时区的时间,可以方便地在不同时区之间转换。整个库的设计风格和 C++11 的 chrono 一脉相承——类型安全、零开销抽象、编译期可计算。对于需要处理日期和时区的应用,这是一个功能完备的标准库解决方案,不再需要依赖第三方库。