最简可靠写法是用 strftime("%j") 获取年积日,它自动处理时区、闰年和偏移;若用 std::chrono(c++20),需用 sys_days 与当年1月1日差值加1,并注意 utc/本地时区差异。

用 std::chrono 和 std::time_t 计算年积日容易出错
直接用 std::chrono 的 system_clock::now() 得到的是时间点,不带年月日语义;想转成“第几天”,必须经过 std::time_t → std::tm 转换,而 std::tm::tm_yday 是从 0 开始计数的(0 表示 1 月 1 日),这点极易漏加 1。
常见错误是:只调 localtime 却忽略线程安全,或用 gmtime 拿到 UTC 时间后误以为是本地年积日。
- 务必用
localtime_r(Linux/macOS)或localtime_s(Windows)替代localtime,避免tm结构体被多线程覆盖 -
tm_yday值范围是 0–365,闰年 2 月 29 日对应 59,12 月 31 日对应 365(平年)或 366(闰年) - 别对
system_clock::time_point直接取模或除以天数——浮点舍入和闰秒会导致偏差
最简可靠写法:用 std::strftime 格式化 %j
%j 是 POSIX 标准格式符,输出三位数字的年积日(001–366),底层已处理时区、闰年和起始偏移,比手动读 tm_yday 更少出错。
注意:strftime 需要 std::tm* 输入,仍需先做 time_t 转换,但无需手动加 1 或边界判断。
time_t now = time(nullptr);
std::tm t{};
#ifdef _WIN32
localtime_s(&t, &now);
#else
localtime_r(&now, &t);
#endif
char buf[4];
strftime(buf, sizeof(buf), "%j", &t);
int day_of_year = std::stoi(buf); // buf 是 "001"、"123" 这类字符串
如果必须用纯 std::chrono(C++20 起)
C++20 引入了 <chrono></chrono> 的日历支持,可绕过 C 风格时间 API,但需注意:它默认按 UTC 解析,且 year_month_day 不直接提供年积日接口。
得组合 sys_days 与当年 1 月 1 日的差值再加 1:
using namespace std::chrono;
auto now = system_clock::now();
auto ymd = floor<days>(now);
auto today = year_month_day{ymd};
auto jan1 = year{today.year()}/1/1;
auto doy = (ymd - sys_days{jan1}) + days{1}; // 注意 + days{1}
int day_of_year = static_cast<int>(doy.count());
</int></days>
-
sys_days{jan1}是 1 月 1 日 00:00:00 UTC 对应的sys_days,不是本地时间 - 若需本地时区年积日,得先用
zoned_time转换,否则结果可能差 1 天(跨时区边界时) - C++20 日历特性在 MSVC 19.30+、GCC 11+、Clang 14+ 才完整支持,旧编译器会编译失败
跨平台封装建议:隐藏 localtime_r/localtime_s 差异
实际项目里别让每个调用点都写条件编译。抽一个内联函数,内部处理平台差异,对外统一返回 int(1–366):
inline int get_day_of_year() {
time_t now = time(nullptr);
std::tm t{};
#if defined(_WIN32)
localtime_s(&t, &now);
#else
localtime_r(&now, &t);
#endif
return t.tm_yday + 1;
}
这个版本最轻量、兼容性最好,也最容易测试——只要确保 tm_yday 加了 1,就不可能返回 0。
真正容易被忽略的是:某些嵌入式环境或精简 libc(如 musl)下 localtime_r 可能不可用,此时得回退到全局 localtime 并加锁,或者改用 C++20 方案(如果编译器支持)。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











