c++oding="utf-8" ?>
c++20 中 std::chrono::zoned_time 用于时区转换,需通过 locate_zone() 获取时区对象,构造时须明确源时区;它不支持直接解析带时区字符串,跨 dst 或历史时间易出错,可靠方案是启用 c++20 时区支持或使用 icu。

std::chrono::zoned_time 在 C++20 中怎么用
标准库从 C++20 开始才原生支持时区转换,依赖 <chrono></chrono> 和 <tz></tz>(后者非标准头文件名,实际是 <chrono></chrono> 提供的扩展,但需编译器启用实验性支持)。主流实现(如 libc++、MSVC 19.3x+、GCC 13+)已部分支持,但行为不完全一致。
关键点:不能直接用 std::chrono::system_clock::time_point 构造带时区的值;必须通过 std::chrono::zoned_time 或 std::chrono::locate_zone() 获取时区对象。
-
std::chrono::locate_zone("Asia/Shanghai")返回const std::chrono::time_zone*,失败时抛std::runtime_error - 构造
zoned_time时,若传入的是本地时间(非 UTC),需显式指定源时区,否则默认按系统本地时区解释 - GCC 13 默认不启用时区数据库,需链接
-lstdc++_libbacktrace或使用std::chrono::reload_tzdb()(可能失败)
示例:把北京时间 2024-06-01 12:00 转成 UTC
auto sh = std::chrono::locate_zone("Asia/Shanghai");
auto tp = std::chrono::sys_days{std::chrono::year_month_day{2024y/6/1}} + 12h;
auto zt = std::chrono::zoned_time{sh, tp};
auto utc = zt.get_sys_time(); // 得到 system_clock::time_point(UTC)
Windows 上用 GetTimeZoneInformation 处理本地时区偏移
Windows API 不提供完整时区数据库,GetTimeZoneInformation 只能获取当前系统设置下的标准/夏令时偏移和名称,无法做任意时区转换(比如把纽约时间转东京时间)。
它返回的 TIME_ZONE_INFORMATION 结构中:Bias 是 UTC 偏移分钟数(西为正),DaylightBias 是夏令时额外偏移(通常 -60),但不包含历史规则或 DST 切换日期。
- 调用后需手动计算当前是否处于夏令时(比较
SYSTEMTIME与StandardDate/DaylightDate字段) - 不能用于解析带时区字符串(如 "2024-06-01T12:00:00-04:00"),
std::get_time不识别时区字段 - 跨年份或跨 DST 边界的时间转换容易出错,尤其在 2007 年前美国 DST 规则变更后
用 ICU 或 tzdata 做可靠跨平台时区转换
如果项目允许引入第三方依赖,ICU(International Components for Unicode)是最成熟的选择;它自带完整 tzdata,支持历史规则、DST、缩写、本地化名称等。
核心类是 icu::TimeZone 和 icu::Calendar,注意 icu::SimpleDateFormat 的模式字符串中 Z 表示 RFC 822 偏移(如 -0500),XXX 才是 ISO 8601 格式(如 -05:00)。
- 时区 ID 必须用 IANA 名称(如
"America/New_York"),不能用缩写("EST"有歧义) - ICU 初始化耗时较长,建议复用
icu::TimeZone::createTimeZone()返回的指针,避免重复解析 - Android NDK 自带 ICU,但默认不启用时区数据;iOS 需自行编译 ICU 或改用 CoreFoundation 的
NSTimeZone
示例:解析带时区字符串并转目标时区
UErrorCode status = U_ZERO_ERROR;
icu::TimeZone* tz = icu::TimeZone::createTimeZone("Asia/Tokyo");
icu::Calendar* cal = icu::Calendar::createInstance(tz, status);
icu::SimpleDateFormat sdf("yyyy-MM-dd HH:mm:ssXXX", "en_US", status);
icu::UnicodeString input(u"2024-06-01 12:00:00-04:00");
icu::Formattable parsed;
sdf.parse(input, parsed, status);
cal->setTime(parsed.getDate(), status); // 转为 Tokyo 时间
解析 ISO 8601 字符串时为什么 std::get_time 失败
std::get_time 对时区支持极弱:C++20 前不识别 %z(仅部分 libstdc++ 实现),C++20 后虽支持 %z,但要求输入严格为 [±]HHMM 格式(如 +0800),不接受 +08:00 或 Z。
更麻烦的是,std::get_time 解析出的 std::tm 不含时区信息,所有偏移被丢弃,后续调用 mktime 会按本地时区解释——这导致 “2024-06-01T12:00:00+08:00” 被当成本地时间再转 UTC,结果错乱。
- 不要用
std::get_time解析带时区的时间字符串,哪怕格式匹配 - 若必须用标准库,先用正则提取
YYYY-MM-DDTHH:MM:SS和±HHMM两部分,再手动调整std::chrono::system_clock::time_point - Boost.DateTime 的
time_input_facet支持%Q(毫秒)、%q(时区),但不维护了;现代项目应优先考虑 ICU 或 date.h
真正可靠的方案,要么用 C++20 zoned_time(确认编译器支持),要么用 ICU——中间没有安全的“轻量级”路径。时区规则本身复杂,任何试图绕过 tzdata 的做法,迟早会在 2038 年、DST 切换日或某个小国修改时区政策时暴露问题。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











