应使用线程安全的localtime_r（POSIX）或localtime_s（Windows）将time_t转struct tm，避免多线程下静态缓冲区冲突；注意time_t为秒级、需处理毫秒截断及时区问题，校验有效性后再提取tm_hour/tm_min/tm_sec。
time_t 转 struct tm 时要用 localtime_r 而不是 localtime
直接用 localtime 提取时分秒在多线程下会出问题，它返回指向静态缓冲区的指针，多个线程调用会互相覆盖。必须改用线程安全的 localtime_r（POSIX）或 localtime_s（Windows）。
-
localtime_r(×tamp, &tm_buf)返回struct tm*，成功时等于&tm_buf，失败返回nullptr - Windows 下用
localtime_s(&tm_buf, ×tamp)，返回errno_t，0 表示成功 -
struct tm中tm_hour、tm_min、tm_sec就是本地时区的时、分、秒（已自动归一化，无需手动 %60）
注意 time_t 的精度和平台差异
time_t 在不同平台可能为 32 位或 64 位整数，但标准只保证它能表示 UTC 时间。如果你拿到的是毫秒级时间戳（比如 JavaScript 或 Java 生成的），不能直接传给 localtime_r —— 它只接受秒级。
- 毫秒转秒：用
timestamp_ms / 1000（整除，丢弃毫秒部分） - 若需保留毫秒并拆分时分秒+毫秒，先用秒部分提取
tm_hour/tm_min/tm_sec，再用timestamp_ms % 1000得到毫秒 - 某些嵌入式环境或旧系统中
time_t是有符号 32 位，2038 年后溢出，此时需确认是否支持 64 位time_t
用 std::chrono::system_clock::from_time_t 更现代但要注意时区
C++11 后推荐用 std::chrono，但 from_time_t 返回的是 UTC 时间点，直接转 std::tm 仍需手动处理时区 —— 它不自动转成本地时间。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 正确做法：
auto tp = std::chrono::system_clock::from_time_t(timestamp);，再用std::chrono::zoned_time（C++20）或借助localtime_r转本地tm - C++11/14 没有原生时区支持，硬要纯 chrono 实现本地时分秒，得自己查 TZ 环境变量 + 手动加偏移，极易出错
- 所以除非项目强制要求无 C 运行时依赖，否则老实用
localtime_r更稳
常见错误：tm_sec 超过 60 或负值
如果发现 tm_sec 是 61、62 或负数，说明输入 time_t 值非法（比如远超 epoch 时间、或被截断过），localtime_r 不会报错，但填充的 tm 成员不可靠。
立即学习“C++免费学习笔记（深入）”；
- 检查
localtime_r返回值是否为nullptr，是则说明timestamp超出系统支持范围 - Linux 上通常支持 ±2^63 秒，但 glibc 对极小或极大值仍可能返回空指针
- 嵌入式或裁剪版 libc（如 musl）对异常时间戳容忍度更低，建议提前用
if (timestamp 2147483647LL * 1000)做粗筛（视目标平台而定）
实际用的时候，最简可靠路径就是：校验 time_t 有效性 → 调 localtime_r → 取 tm.tm_hour、tm.tm_min、tm.tm_sec。其他包装都容易在边界或跨平台时翻车。
