最便携方式是用std::chrono::system_clock::now()转time_t再调localtime_r(POSIX)或localtime_s(MSVC)获取本地年月日;C++20推荐std::format("{:%Y-%m-%d}", system_clock::now()),线程安全且简洁。

用 std::chrono + std::time_t 获取本地当前日期(C++11 及以上)
标准库不直接提供“年月日”结构体,但可通过 std::chrono::system_clock 和 std::localtime 组合拿到。这是最便携、无需第三方依赖的方式。
常见错误是直接对 system_clock::now() 调用 std::localtime——它只接受 time_t,不是 time_point。
- 先用
system_clock::to_time_t(system_clock::now())转成time_t - 再传给
localtime(注意:线程不安全;多线程下建议用localtime_r(POSIX)或localtime_s(MSVC)) -
tm结构中:tm_year是从 1900 开始的偏移,tm_mon是 0–11,tm_mday是 1–31
示例:
auto now = std::chrono::system_clock::now();
std::time_t t = std::chrono::system_clock::to_time_t(now);
std::tm lt{};
#ifdef _WIN32
localtime_s(<, &t);
#else
localtime_r(&t, <);
#endif
int year = lt.tm_year + 1900;
int month = lt.tm_mon + 1;
int day = lt.tm_mday;
用 std::format 格式化为字符串(C++20)
如果你只要字符串形式(如 "2024-05-21"),C++20 的 std::format 最简洁,且线程安全。
立即学习“C++免费学习笔记(深入)”;
注意:GCC 13+、Clang 15+、MSVC 19.32+ 才完整支持;旧编译器会编译失败。
- 必须包含
<format>头文件 -
std::format接收的是std::chrono::system_clock::time_point,不能直接传tm - 格式符
"%Y-%m-%d"是 C 风格,std::format使用{:%Y-%m-%d}语法
示例:
#include <format>
#include <chrono>
auto now = std::chrono::system_clock::now();
std::string s = std::format("{:%Y-%m-%d}", now); // "2024-05-21"
跨平台兼容性陷阱:时区与线程安全
std::localtime 返回静态缓冲区指针,多线程下会互相覆盖;Windows 下还可能因时区缓存导致首次调用不准。
- Linux/macOS:优先用
localtime_r(&t, &tm),tm必须是栈/堆上已分配的变量 - Windows:用
localtime_s(&tm, &t),参数顺序和返回值与 POSIX 不同 - 若需 UTC 时间,用
gmtime_r/gmtime_s,避免本地时区干扰 - 某些嵌入式环境或 freestanding 实现可能没有
localtime,此时只能靠系统 API(如gettimeofday)或第三方库
不推荐:手动解析 std::chrono::year_month_day(C++20)
std::chrono::year_month_day 看起来更现代,但它默认基于 UTC,且构造时需显式转换,容易忽略时区偏移。
例如:year_month_day{floor<days>(system_clock::now())} 得到的是 UTC 日期,不是你本地看到的日历日期。
- 要得到本地日期,得先转
time_t→localtime→ 再构造year_month_day,绕路且无优势 -
year_month_day没有内置格式化方法,仍需转回tm或用std::format - 除非你在做高精度时间运算或需要
year/month类型语义,否则没必要引入这套类型
真正容易被忽略的是:日期 ≠ 时间戳。哪怕只是取“今天”,也必须明确是“本地日历日”还是“UTC 日”,否则在跨时区服务或日志归档时会出错。


















