localtime_r()是posix系统上最常用且线程安全的秒级时间转换方法，它不依赖静态缓冲区，需传入已分配的struct tm地址，返回值仅用于判空；windows应改用localtime_s()，毫秒时间需先整除1000再转换。
localtime_r() 是最常用且安全的秒级转换方法
直接调用 localtime_r() 是 POSIX 系统（Linux/macOS）上将 time_t 转为本地 struct tm 的事实标准。它不依赖静态缓冲区，线程安全，且开销极小——本质就是一次时区查表 + 字段填充，没有字符串解析或系统调用。
- 必须传入已分配的
struct tm地址，不能传栈上未初始化的野指针 - 返回值为
struct tm*，但实际只用于判空；成功时指针与输入地址一致 - 若需 UTC 时间，改用
gmtime_r()，性能几乎相同 - Windows 不支持
localtime_r()，应改用localtime_s()，语义等价
避免 localtime() —— 它不是“快”，而是“危险”
localtime() 看似少写一个参数，但它返回指向内部静态缓冲区的指针。多线程下极易被覆盖，导致时间错乱（比如日志里突然出现 1970 年的时间）。这不是性能问题，是数据竞争问题——哪怕单线程程序未来加了日志异步写入，也会崩。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 即使你确认当前是单线程，
localtime()仍可能被其他库函数（如strtok()、gethostbyname()）意外覆盖 - 编译器无法检测该风险，错误只在高并发或特定调度路径下暴露
- 替换成本极低：
localtime(&t)→localtime_r(&t, &tm)
毫秒级时间戳不能直接用 localtime_r()
localtime_r() 只接受 time_t（秒级），对毫秒级整数（如 1722117600123）会截断为秒，丢失毫秒部分。强行除 1000 再传入，虽能得日期时间，但毫秒信息必须单独提取并拼接。
- 先做整除：
time_t sec = ms / 1000;，再调localtime_r(&sec, &tm) - 毫秒部分用
int ms_part = ms % 1000;获取 - 格式化时需用
strftime()拼基础时间，再手动追加.%03d格式化毫秒 - 别试图把毫秒塞进
tm_sec——该字段只接受 0–61，超出将导致mktime()解析失败
跨平台代码要处理 _WIN32 宏分支
POSIX 和 Windows 的可重入函数名不同，硬写 localtime_r 在 Windows 上编译不过。必须用预处理器区分：
#ifdef _WIN32
localtime_s(&tm, &raw_time);
#else
localtime_r(&raw_time, &tm);
#endif
- 不要依赖第三方封装（如 Boost.Date_Time），纯 stdlib 就够用且无额外依赖
- 某些嵌入式 libc（如 newlib）可能不提供
_r版本，此时需确保单线程或自行加锁 - 即使只跑 Linux，也建议统一用宏分支写法——避免将来移植到 Windows 时返工
localtime_r() 这类函数全部满足“零分配、无锁、无 syscall”，已是理论最快路径。容易被忽略的是：**时区数据库加载（如 /usr/share/zoneinfo）只在进程首次调用时发生，后续调用完全在内存中完成**——这个隐式开销常被误认为是函数本身慢。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
