最推荐用 std::chrono::system_clock::now() 配合 std::format(C++20),它线程安全、类型安全、无需手动处理时区;若需兼容 C++11,则用 localtime_r/localtime_s + strftime,避免 std::put_time 的线程不安全和缓冲区风险。

用 std::chrono + std::format(C++20)最简洁可靠
如果你的编译器支持 C++20 且启用了 std::format(如 MSVC 19.3x+、GCC 13+、Clang 15+),这是目前最现代、线程安全、无需手动处理时区偏移的方式:
-
std::chrono::system_clock::now()获取当前时间点,它默认对应本地时区(实际是 UTC,但std::format会按本地时区渲染) -
std::format自动调用本地 locale 的时间格式化规则,包括 AM/PM、月份名、数字分隔符等 - 注意:
std::format对std::chrono::time_point的支持依赖标准库实现;GCC 13 默认不启用std::formatfor time,需确认是否链接了libstdc++_filesystem或使用-D_GLIBCXX_USE_CXX11_ABI=1
auto now = std::chrono::system_clock::now();
std::string s = std::format("{:%Y-%m-%d %H:%M:%S}", now); // 如 "2024-06-12 14:23:05"
兼容 C++11 的方案:用 std::localtime + std::strftime
这是最广泛可用的方法,但必须注意线程安全和 DST 处理:
-
std::localtime返回的是静态缓冲区指针,多线程下直接调用会互相覆盖 → 必须用std::localtime_r(POSIX)或std::localtime_s(Windows)替代 -
std::time(nullptr)获取秒级时间戳,再转为std::tm结构体 -
std::strftime格式化时,%Z输出时区缩写(如 “CST”),%z输出 UTC 偏移(如 “+0800”),但二者都依赖系统时区设置,不会自动更新
std::time_t t = std::time(nullptr);
std::tm tm_buf{};
#ifdef _WIN32
std::localtime_s(&tm_buf, &t);
#else
std::localtime_r(&t, &tm_buf);
#endif
char buf[64];
std::strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S %Z", &tm_buf);
std::string s(buf);
为什么不用 std::put_time?
std::put_time 看似方便,但它底层仍调用 std::localtime,在多线程中不安全,且无法控制缓冲区大小,容易导致截断或未定义行为:
- 它内部使用静态
std::tm*,和裸调std::localtime是同一类风险 - 格式化结果写入
std::ostream,若目标流异常(如std::ostringstream内存不足),可能静默失败 - 没有返回值或错误码,调试困难;尤其在嵌入式或资源受限环境里,
std::ostringstream开销也偏大
跨平台获取带毫秒的时间字符串要小心时区缓存
如果需要毫秒精度(比如日志打点),不能只靠 std::chrono::system_clock::now() 转 std::tm —— 因为 std::localtime 系列函数基于秒级时间戳,毫秒信息会丢失;更严重的是,部分 libc 实现(如旧版 musl)会缓存时区规则,导致程序运行期间切换系统时区后,时间字符串仍显示旧偏移。
立即学习“C++免费学习笔记(深入)”;
- 正确做法:先用
std::chrono::system_clock::now()拆出秒和毫秒部分,再用秒部分调用线程安全的本地时区转换函数 - Windows 上可考虑
GetLocalTime+SYSTEMTIME,它原生支持毫秒且不依赖 C 运行时的时区缓存 - Linux/macOS 若需高可靠性,建议用
tzset()手动刷新时区,再调用localtime_r,但要注意tzset()不是异步信号安全的
真正麻烦的地方不在“怎么取时间”,而在于“本地时间”的定义本身模糊:是系统当前时区?还是用户 locale 设置?还是进程启动时的快照?多数场景下你其实只需要一个稳定、可读、线程安全的字符串,而不是严格符合某个时区规范的值。


















