转换 time_t 时需明确时区：localtime_r() 得本地时间（注意系统时区影响），gmtime() 得 UTC；struct tm 字段需全量初始化（如用 localtime_r 填充），tm_year 加 1900、tm_mon 加 1 后再格式化；推荐 std::put_time 安全格式化。
time_t 转 struct tm 时要注意时区问题
直接用 localtime() 或 gmtime() 转换 time_t，结果取决于你想要本地时间还是 UTC。很多 bug 源于默认用了 localtime() 却没意识到它受系统时区影响——比如服务器在 UTC，开发机在 CST，同一时间戳输出的小时差 8 小时。
-
localtime()返回本地时区的struct tm，线程不安全；多线程下优先用localtime_r()（Linux/macOS）或localtime_s()（Windows） -
gmtime()返回 UTC 时间，适合日志统一时间基准，但显示给用户前通常要转本地时区 - 注意：
struct tm的tm_year是从 1900 开始计数，tm_mon是 0–11，打印前必须手动加偏移
用 std::put_time 格式化 struct tm 更安全
C++11 起推荐用 std::put_time 替代 C 风格的 strftime()，类型更安全、支持流操作。但它只接受 const std::tm*，且要求传入的 struct tm 必须是完整初始化的（比如用 localtime_r 填充后不能只改几个字段）。
- 常见错误：把
std::tm t = {}空初始化后只设t.tm_sec等几个字段，其余为随机值，put_time行为未定义 - 正确写法：用
localtime_r(&ts, &t)全量填充，再传给std::put_time - 格式符和
strftime()一致：%Y-%m-%d %H:%M:%S→"2024-05-21 14:36:02"
time_t ts = 1716302162;
std::tm t = {};
localtime_r(&ts, &t);
std::ostringstream oss;
oss << std::put_time(&t, "%Y-%m-%d %H:%M:%S");
std::string s = oss.str(); // "2024-05-21 14:36:02"
需要毫秒级精度？别用 time_t
time_t 通常是秒级整数（POSIX 要求），无法表示毫秒。如果原始时间戳是毫秒（比如 JavaScript Date.now() 或某些 API 返回），必须先除以 1000 再转 time_t，余数单独处理。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 错误做法：
static_cast<time_t>(1716302162123)→ 溢出或截断成错误秒数 - 正确做法：用
std::chrono处理高精度时间戳更可靠 - 示例：毫秒时间戳转带毫秒的字符串，需拆成秒 + 毫秒两部分，
struct tm只管秒，毫秒拼接到末尾
int64_t ms = 1716302162123;
time_t sec = ms / 1000;
int ms_part = ms % 1000;
std::tm t = {};
localtime_r(&sec, &t);
std::ostringstream oss;
oss << std::put_time(&t, "%Y-%m-%d %H:%M:%S") << '.' << std::setfill('0') << std::setw(3) << ms_part;
// → "2024-05-21 14:36:02.123"
跨平台时 localtime_r 和 localtime_s 的兼容性处理
Linux/macOS 用 localtime_r()，Windows 用 localtime_s()，两者参数顺序相反，硬写宏判断容易出错。最简方案是封装一层：
立即学习“C++免费学习笔记（深入）”；
- Windows 下
localtime_s(&t, &ts)返回errno_t，成功为 0；Linux 下localtime_r(&ts, &t)返回struct tm*，失败返回nullptr - 不要忽略返回值检查——尤其嵌入式或容器环境里，
tzset()未调用可能导致localtime_r失败 - 如果项目已用 C++20，可直接用
std::chrono::zoned_time，但目前主流编译器支持仍有限
