C++如何判断日期是否为该年的第一天

判断 std::tm 是否表示年份第一天

最直接的办法，就是看 tm_mday == 1 && tm_mon == 0。C++ 的 std::tm 里，tm_mon 从 0 开始（0 代表一月），tm_mday 从 1 开始（1 代表当月第一天）。所以“该年第一天”就是一月一日，条件自然就是月份为零、日期为一。

这里有个细节：tm_year 虽然表示自 1900 年起的偏移（比如 2024 年是 124），但它不参与判断——只要月份和日期对了，那就是年初，不管年份值有没有经过归一化。如果数据来自 std::localtime 或 std::gmtime，这两个函数返回的 tm 已经归一化，直接用 tm_mday 和 tm_mon 就行。但如果是手动构造的 std::tm（比如解析字符串后填值），一定要确保 tm_mon 在 [0,11] 范围内，否则 tm_mon == 0 可能是无效输入，而非真正的1月。

顺便提一句，tm_yday（一年中的第几天）也能用：tm_yday == 0 就是年初。但问题是，这个字段在调用 mktime 之前可能根本没填充，甚至可能是个 -1，所以用它判断不太靠谱。

从字符串解析后验证是否为年初

常见场景是：读取 "2024-01-01" 这种 ISO 格式字符串，想快速确认是不是当年第一天。这时别急着转 std::time_t，先做轻量级文本校验更高效。对于形如 "YYYY-MM-DD" 的固定格式字符串（长度10，带两个短横），只要检查：前4位是数字（年份），第5–6位是 "01"，第8–9位是 "01"。比如 "2024-01-01" ✅，"2024-01-02" ❌，"2024-12-01" ❌。这种检查不依赖 locale、不调用库函数、没有解析开销，特别适合高频校验。

如果输入的格式不固定（比如 "1/1/2024"），那就老老实实用 std::get_time 解析到 std::tm，再按前面的方式判断。

用 std::chrono::year_month_day 判断（C++20）

C++20 提供了类型安全的日期类型 std::chrono::year_month_day，语义清晰，构造后直接比对：

auto ymd = std::chrono::year_month_day{std::chrono::sys_days{tp}};  
if (ymd.month() == std::chrono::January && ymd.day() == std::chrono::day{1}) { /* 是年初 */ }

注意几点：第一，时间点 tp（比如 std::chrono::system_clock::time_point）必须先转成 sys_days，再隐式转为 year_month_day。第二，month() 返回的是 std::chrono::month，不能直接和整数 1 比较，得用 std::chrono::January 或 std::chrono::month{1}。第三，这种方式线程安全、无副作用，但需要编译器支持 C++20（MSVC 19.30+、GCC 11+、Clang 14+ 完整支持）。

容易忽略的边界：闰秒、时区与本地时间偏差

“一年的第一天”本质上是日历概念，不是时间轴上的绝对点。所有判断都应该基于本地日历或明确指定时区的日期，而不是 UTC 时间戳本身。举个例子：一台服务器在东京（UTC+9），2024-01-01T00:00:00+09:00 是年初；但同一时刻的 UTC 时间是 2023-12-31T15:00:00Z，如果错误地用 UTC 的 tm 结构去判断，就会得出“不是年初”的错误结论。

具体使用中要注意：std::localtime 的结果依赖 tzset() 和环境变量 TZ，而且多线程下存在静态缓冲区竞争。C++20 的 std::chrono::zoned_time 可以显式绑定时区，避免歧义。至于闰秒，它只在6月底或12月底出现，跟1月1日没关系，不影响判断。

真正需要盯住的，是输入源的时间基准：它标的是本地时间？UTC？还是某个固定时区？没理清这个，代码逻辑再正确也会出错。