C++ std::format 自定义日期与时间模板的格式化输出 _ 现代 C++ 技巧【实战】-C++-PHP中文网

std::format 不支持 locale 本地化日期输出，%y、%b、%x 等始终按 c locale 解析，std::locale 参数被静默丢弃；真本地化须用 std::put_time + std::ostringstream 配合 std::time_put facet。

c++ std::format 自定义日期与时间模板的格式化输出 _ 现代 c++ 技巧【实战】

std::format 不能靠 locale 实现中文/德文等本地化日期输出，所有 {:%Y}、{:%B}、{:%x} 都按 C locale 固定解析，传入的 std::locale 参数会被静默丢弃——这不是 bug，是 C++20 标准行为。

std::format("{:%Y年%m月%d日}", tp) 看似能用，实则危险

它输出 “2026年04月30日” 是因为 “年”“月”“日” 是 UTF-8 字面量，被原样拼接；而 %Y 和 %m 仍走 C locale（永远是 “2026”“04”，不是 “二〇二六”“四”）。真正本地化需要月份名翻译、日期顺序切换（如德语 %d.%m.%Y），std::format 完全不查 std::time_put facet，也不支持 {:L} 扩展。

编译能过只是侥幸：格式串里混中文不报错，但属于硬编码，和 locale 无关
跨平台风险高：Windows 上 zh_CN.UTF-8 极可能构造失败，而 std::format(loc, ) 中的 loc 会被直接丢弃
%x 在任意 locale 下都输出美式 05/10/26，不会变成中文 26/05/10 或德文 10.05.26

std::format 只接受 zoned_time 或 sys_time，不认 time_t 和 tm*

直接传 std::time_t 或 struct tm* 会编译失败，报错类似 no matching function for call to 'format'。C++20 日历与时钟类型才是唯一合法输入源。

C函数速查手册（CHM版）

下载

正确路径：std::chrono::system_clock::from_time_t(t) → sys_time → （可选）zoned_time{zone, tp}
想输出本地时间？必须经 zoned_time 中转，不能靠 std::localtime() 后再塞进 std::format
UTC 时间最稳：std::chrono::utc_clock::now() + std::format("{:%Y-%m-%d %H:%M:%S}Z", utc_now)

带时区输出必须用 zoned_time，%Z 和 %z 仅对其有效

%Z 输出时区缩写（如 CST），%z 输出 UTC 偏移（如 +0800），但这两个说明符对 sys_time 或 utc_time 使用时会被静默忽略——只在 zoned_time 上有意义。

先确认时区存在：std::chrono::get_tzdb().zones 遍历，别直接 locate_zone("Asia/Shanghai")，否则可能抛 std::runtime_error
安全链路示例：auto zt = std::chrono::zoned_time{std::chrono::current_zone(), std::chrono::system_clock::now()}; → std::format("{:%Y-%m-%d %H:%M:%S %Z}", zt)
若需偏移而非缩写，用 %z；但注意它输出的是 +0800，不是 +08:00（后者需手动拆解拼接）

真要本地化？切回 std::put_time + std::ostringstream

std::format 不走 locale 路线，唯一合规路径是传统流机制：imbue() 激活 facet，靠 std::put_time 驱动 std::time_put::put() 实现翻译与顺序适配。

关键三步：std::locale loc{"zh_CN.UTF-8"} → oss.imbue(loc) → oss , "%Y年%m月%d日")
注意转换：std::chrono::system_clock::time_point 必须先过 std::chrono::system_clock::to_time_t()，再 std::localtime()；不能直接传 tp
Linux/macOS 通常预装完整 locale 数据；Windows 需确认系统是否启用对应语言，且 "Chinese_China.936" 或 "zh-CN" 兼容性更稳