最直接的方式是用 std::put_time 配合 std::chrono::system_clock::to_time_t;需先转 time_t 再转 tm(注意平台安全函数),最后用 std::put_time 格式化输出。

用 std::put_time 配合 std::chrono::system_clock::to_time_t 是最直接的方式
C++ 标准库不提供直接把 std::chrono::time_point 格式化为字符串的函数,必须先转成 C 风格的 std::time_t,再用 std::put_time 输出。这是目前最便携、无需第三方依赖的做法。
常见错误是试图对 time_point 直接调用 std::strftime 或误用 std::localtime 而不检查返回值(可能为 nullptr)。
-
std::chrono::system_clock::to_time_t只适用于system_clock;若用steady_clock或自定义时钟,不能这么转 - 注意时区:
std::localtime用本地时区,std::gmtime用 UTC;两者返回的std::tm*指针需确保非空 -
std::put_time是 C++11 引入的流操作器,只支持宽字符流(std::wostream)和窄字符流(std::ostream),不能用于sprintf类风格缓冲区写入
auto now = std::chrono::system_clock::now();
std::time_t t = std::chrono::system_clock::to_time_t(now);
std::tm tm_buf {};
#ifdef _WIN32
localtime_s(&tm_buf, &t); // Windows 安全版
#else
localtime_r(&t, &tm_buf); // POSIX 线程安全版
#endif
std::ostringstream oss;
oss << std::put_time(&tm_buf, "%Y-%m-%d %H:%M:%S");
std::string s = oss.str(); // "2024-06-15 14:23:07"
格式化字符串里哪些 % 占位符最常用
日期时间格式完全由 std::put_time 的第二个参数控制,它复用 C 的 strftime 规则。实际开发中高频使用的就几个:
-
%Y:4 位年份(如2024),别用%y(2 位,易歧义) -
%m:补零月份(01–12),%B是完整英文名(June),但不可移植(locale 依赖) -
%d:补零日期(01–31);%e不补零(POSIX 扩展,某些平台不支持) -
%H:%M:%S:24 小时制时分秒;%I:%M:%S %p是 12 小时制(02:23:07 PM) -
%z:UTC 偏移(如+0800),但需先调用std::time_t对应的std::localtime,且不是所有平台都填对
跨平台时 std::localtime 容易崩,必须做空指针防护
在嵌入式环境、容器或某些精简 libc 实现中,std::localtime 可能返回 nullptr(例如时区数据库缺失、TZ 环境变量非法)。不检查就解引用会导致段错误。
立即学习“C++免费学习笔记(深入)”;
- Windows 下优先用
localtime_s(C11 标准,MSVC 支持) - Linux/macOS 用
localtime_r(POSIX 线程安全版),传入栈上std::tm缓冲区地址 - 如果连
_r/_s版本都不支持,只能用老式localtime+ 全局std::tm*,但要加锁或限制为单线程场景 - 不要依赖
std::put_time抛异常来捕获格式错误——它通常静默失败或输出空字符串
毫秒级精度怎么保留
std::time_t 只有秒级精度,原始 time_point 的毫秒/微秒信息会丢失。若需带毫秒的字符串(如 "2024-06-15 14:23:07.123"),得手动拼接:
- 先用
to_time_t截断到秒,格式化基础部分 - 再用
time_point.time_since_epoch().count()减去秒数部分,换算成毫秒余数 - 注意:不同时钟的
period不同,system_clock通常是纳秒或微秒,需除以1'000'000(微秒)或1'000'000'000(纳秒)得到秒
auto now = std::chrono::system_clock::now();
auto ms = std::chrono::duration_cast<std::chrono::milliseconds>(now.time_since_epoch()).count();
auto sec = ms / 1000;
auto ms_frac = ms % 1000;
std::time_t t = static_cast<std::time_t>(sec);
// ... 格式化 t 得到 "2024-06-15 14:23:07"
// 再拼接 << '.' << std::setfill('0') << std::setw(3) << ms_frac;
毫秒拼接这步没有标准流操作器支持,必须自己处理补零和小数点——这也是最容易漏掉的细节。


















