C++怎样格式化日期字符串

推荐优先使用C++20 std::format，需将time_point转为标准chrono类型并截断精度；次选std::put_time配合线程安全的localtime_r/gmtime_r；跨平台时须强制"C" locale避免strftime本地化问题。

用 std::format（C++20）直接格式化日期

如果你的编译器支持 C++20 且启用了 std::format（如 GCC 13+、Clang 15+、MSVC 19.30+），这是最干净的方式。它内置支持 std::chrono::system_clock::time_point 和 std::chrono::year_month_day 等类型。

常见错误是传入 raw time_t 或 struct tm —— std::format 不接受这些，必须先转成标准 chrono 类型。

• 先用 std::chrono::system_clock::now() 获取时间点，再用 std::chrono::floor<:chrono::seconds></:chrono::seconds> 截断纳秒，避免格式化出小数秒
• 格式字符串用 {:%Y-%m-%d %H:%M:%S}，其中 % 转义符和 printf 风格一致，但仅支持 ISO 8601 相关字段（%Z、%z 在部分标准库中仍不可用）
• 示例：

  auto now = std::chrono::floor<std::chrono::seconds>(std::chrono::system_clock::now());<br>std::string s = std::format("{:%Y-%m-%d %H:%M:%S}", now);

用 std::put_time（C++11）配合 std::localtime / std::gmtime

这是兼容性最广的方案，所有支持 C++11 的标准库都可用，但要注意线程安全和时区陷阱。

典型问题：直接对 std::time(nullptr) 返回的 time_t 调用 std::localtime，结果可能被后续调用覆盖（因为返回的是静态缓冲区指针）；多线程下尤其危险。

立即学习“C++免费学习笔记（深入）”；

• 务必用 std::localtime_r（POSIX）或 std::localtime_s（Windows）替代 std::localtime，确保线程安全
• 如果需要 UTC 时间，用 std::gmtime_r / std::gmtime_s，别依赖 std::put_time 自动识别时区
• 示例（POSIX）：

  std::time_t t = std::time(nullptr);<br>struct tm buf{};<br>std::localtime_r(&t, &buf);<br>std::ostringstream oss;<br>oss << std::put_time(&buf, "%Y-%m-%d %H:%M:%S");<br>std::string s = oss.str();

跨平台封装时避开 strftime 的 locale 依赖

strftime 看似简单，但默认受当前 locale 影响：比如 %B 在中文 locale 下输出“十二月”，而非 “December”。很多服务端程序因此出现日志乱码或解析失败。

除非你明确需要本地化名称（如 UI 层），否则应强制设为 "C" locale 来保证可移植性。

• 调用前执行 std::setlocale(LC_TIME, "C")，注意该函数不是线程安全的
• 更稳妥的做法是用 std::locale::global(std::locale("C"))（影响整个程序）或在格式化前临时切换 locale 并恢复
• 若只处理数字型字段（%Y、%m、%d），其实不受 locale 影响，可跳过这步

第三方库选 date.h 还是 fmt？

Howard Hinnant 的 date.h（已并入 C++20 <chrono>）和 fmt 库都提供更灵活的日期格式化能力，但引入方式不同。

容易踩的坑是：以为 fmt::format 支持所有 strftime 格式符——实际上它只支持子集，且对 std::chrono::zoned_time 等高级类型的支持依赖编译选项（如 FMT_LOCALE）。

• date.h 更专注时间，适合需要时区、历法计算的场景，但头文件较大、编译慢
• fmt 更通用，若项目已用它做字符串格式化，复用 fmt::format 可减少依赖，但需确认版本（≥10.0 才完整支持 chrono 格式化）
• 二者都不修改全局 locale，规避了 std::put_time 的隐式依赖问题

真正麻烦的从来不是“怎么拼出 YYYY-MM-DD”，而是时区、线程安全、locale 和跨平台行为的一致性。哪怕只用 std::put_time，也得盯住那个 _r 或 _s 后缀。