<p>std::format 日期格式化仅支持 std::chrono::sys_time、utc_time 和 zoned_time 类型，传 std::time_t 或 struct tm* 会编译失败；%Z 和 %z 仅对 zoned_time 有效，{:%x} 忽略 locale 且固定为美式格式。</p>
std::format 日期格式化必须用 std::chrono::zoned_time 或 sys_time
直接传 std::time_t 或 struct tm* 给 std::format 会编译失败，不是遗漏头文件的问题，而是类型不匹配。C++20 的 std::format 对时间类型的接受范围非常严格：只认 std::chrono::sys_time（即 std::chrono::time_point<system_clock>）、std::chrono::utc_time 和 std::chrono::zoned_time。
常见错误写法：
std::time_t now = std::time(nullptr);
std::format("{:%Y-%m-%d}", now); // ❌ 编译错误：no matching function
正确路径分三步：
- 先用
std::chrono::system_clock::now()获取sys_time - 若需本地时区，必须经
std::chrono::zoned_time{std::chrono::current_zone(), tp}中转（不能用std::localtime） - 再传给
std::format，格式说明符必须带:和%，例如{:%Y-%m-%d %H:%M:%S}
时区缩写和 UTC 偏移只对 zoned_time 有效
%Z（如 CST、PDT）和 %z（如 +0800、-0700）这两个说明符在 std::format 中是“有状态”的——它们只在参数是 zoned_time 时才输出真实值；传 sys_time 或 utc_time 会静默忽略，结果为空字符串或未定义行为。
立即学习“C++免费学习笔记（深入）”；
例如：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
auto tp = std::chrono::system_clock::now();
auto zt = std::chrono::zoned_time{"Asia/Shanghai", tp};
std::format("{:%Y-%m-%d %H:%M:%S %Z}", zt); // ✅ 输出 "2026-07-27 16:33:45 CST"
std::format("{:%Y-%m-%d %H:%M:%S %Z}", tp); // ❌ %Z 被丢弃，只输出 "2026-07-27 16:33:45 "
注意：std::chrono::locate_zone("Asia/Shanghai") 可能抛 std::runtime_error，建议先查 std::chrono::get_tzdb().zones 确认时区存在，或 fallback 到 UTC。
{:%x} 看似本地化，实则完全不走 std::locale
{:%x} 在所有平台都输出美式格式（如 07/27/26），哪怕你显式传了 std::locale("zh_CN.UTF-8") ——标准明确要求它忽略 locale 参数，只按 C locale 解析。中文“年”“月”“日”能显示，只是因为它们是 UTF-8 字面量，被原样拼进字符串，和本地化无关。
真正需要本地化（比如把 “July” 翻成 “七月”，或把顺序改成 27/07/2026）时，std::format 无解。唯一合规做法是切回传统流：
std::ostringstream oss;
oss.imbue(std::locale("zh_CN.UTF-8"));
oss << std::put_time(&tm, "%Y年%m月%d日 %H:%M:%S");
别指望 std::format(loc, ...) 能驱动日期本地化，那是对标准的误读。
宽字符、自定义结构体、编译期检查这些坑容易一起爆
三个高频连环雷：
-
std::wstring不能直传 ——std::format("time: {}", my_wstr)编译报错no matching function，必须先转 UTF-8（如用std::wstring_convert<std::utf8_codecvt_facet>或 C++11 后更安全的std::codecvt_utf8） - 自定义类型想用
{}占位，必须完整特化std::formatter<MyType>，漏掉parse()函数会导致运行时报invalid format string，而不是编译错误 - 启用编译期检查需确保编译器+标准库组合支持：GCC 13 默认开，MSVC 19.30+ 需定义
_HAS_CXX20=1，Clang 15 及更早即使加-std=c++20也找不到std::format
最常被忽略的一点：日期格式化不是“写了 {:%Y} 就能跑”，它依赖整个时区数据库（tzdb）加载成功。调试时看到 std::format 崩溃在 locate_zone，八成是时区名拼错或 tzdb 初始化失败，而不是格式串问题。
