time_t是秒级而非毫秒级，直接传入毫秒时间戳会导致时间错乱；正确做法是先除以1000截断得秒值，再用localtime_r/gmtime_r转换，毫秒部分单独用%1000提取。
time_t 是秒级，不是毫秒级
直接用 localtime 或 gmtime 处理毫秒时间戳会出错——这两个函数只接受 time_t，而 time_t 语义上是“自 Epoch 起的秒数”，不是毫秒。传入毫秒值（比如 1717023600000）会被当作“公元 54000 多年”的时间，结果完全错乱。
正确做法是先除以 1000 截断毫秒部分，得到秒级时间戳，再转 struct tm：
int64_t ms = 1717023600123; time_t sec = ms / 1000; // 注意：向零截断，非四舍五入 struct tm tm_buf; localtime_r(&sec, &tm_buf); // 推荐用 _r 版本，线程安全
- 用
localtime_r而非localtime，避免静态缓冲区冲突 -
ms / 1000是整除，丢弃毫秒部分；如需四舍五入到最近秒，用(ms + 500) / 1000 - Windows 下无
localtime_r，改用localtime_s(&tm_buf, &sec)
毫秒部分要单独提取，struct tm 不存毫秒
struct tm 最细粒度只到秒（tm_sec），毫秒信息无法写入该结构体。如果你需要毫秒（比如日志打点、高精度时间比对），必须额外保存：
int64_t ms = 1717023600123; time_t sec = ms / 1000; int milli = ms % 1000; // 得到 123 struct tm tm_buf; localtime_r(&sec, &tm_buf); // 现在 tm_buf 包含时分秒，milli 是独立变量
-
ms % 1000正确取毫秒，但注意负时间戳：C++ 中负数取模行为依赖实现，稳妥起见先做非负处理 - 若需微秒或纳秒，同理用
% 1000000或% 1000000000，但前提是原始时间戳单位足够细 - 别试图把毫秒塞进
tm_sec或其他字段——会破坏mktime可逆性，且标准库不认可
C++20 std::chrono 更安全，但要注意时区
如果项目已用 C++20，std::chrono 是更现代的选择，但默认解析为本地时间需显式指定时区：
立即学习“C++免费学习笔记（深入）”；
#include <chrono> #include <ctime> auto ms = std::chrono::milliseconds(1717023600123); auto sys_time = std::chrono::time_point<std::chrono::system_clock>(ms); std::time_t t = std::chrono::system_clock::to_time_t(sys_time); struct tm tm_buf; localtime_r(&t, &tm_buf);
- 别漏掉
std::chrono::system_clock::to_time_t()这一步，time_point不能直接传给localtime_r -
system_clock通常对应 Unix 时间（UTC），所以localtime_r才能转成本地时区；若用gmtime_r，则得 UTC 时间 - 某些平台
system_clock的 epoch 可能不是 Unix 时间，但主流编译器（GCC/Clang/MSVC）均已对齐
跨平台处理负时间戳要小心
毫秒时间戳为负（比如表示 1970 年前的时间），在除法和取模时行为不一致：
- Linux/macOS：
-1234 / 1000 == -1，-1234 % 1000 == -234 - Windows MSVC：
-1234 / 1000 == -1，-1234 % 1000 == -234（C++11 起标准化，基本一致） - 但若手动做“向上取整”或“对齐到秒起点”，负数逻辑容易翻车
稳妥做法是先转为非负等效时间再算，或用 std::div 一次获取商和余数：
auto d = std::div(ms, 1000); time_t sec = d.quot; int milli = d.rem < 0 ? d.rem + 1000 : d.rem; // 标准化余数为 [0, 999]
这个细节在金融系统、历史数据回放等场景容易被忽略，一出错就是时间倒流或偏移一整天。
