C++ 将时间戳转换为可读的日期格式-C++-PHP中文网

转换 time_t 时需明确时区：localtime_r() 得本地时间（注意系统时区影响），gmtime() 得 utc；struct tm 字段需全量初始化（如用 localtime_r 填充），tm_year 加 1900、tm_mon 加 1 后再格式化；推荐 std::put_time 安全格式化。

c++ 将时间戳转换为可读的日期格式

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 填充后不能只改几个字段）。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

常见错误：把 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 

<h3>需要毫秒级精度？别用 time_t</h3>
<p><code>time_t</code> 通常是秒级整数（POSIX 要求），无法表示毫秒。如果原始时间戳是毫秒（比如 JavaScript <code>Date.now()</code> 或某些 API 返回），必须先除以 1000 再转 <code>time_t</code>，余数单独处理。</p>

错误做法：static_cast<time_t>(1716302162123)</time_t> → 溢出或截断成错误秒数
正确做法：用 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 

<h3>跨平台时 localtime_r 和 localtime_s 的兼容性处理</h3>
<p>Linux/macOS 用 <code>localtime_r()</code>，Windows 用 <code>localtime_s()</code>，两者参数顺序相反，硬写宏判断容易出错。最简方案是封装一层：</p>

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，但目前主流编译器支持仍有限