节假日判断不能靠 std::chrono 自动推导，必须查表或调用外部服务；推荐预置 json 表（含 holiday/workday 列表），配合农历库或直接列出未来多年公历日期，并确保本地缓存与运营维护。
节假日判断不能靠 std::chrono 自动推导
标准 C++ 库（包括 std::chrono）完全不包含任何节假日知识，它只处理时间点、时长和日历算术，不感知“五一”“春节”“调休”等语义。试图用日期运算自动识别法定节假日——比如“每年10月1日是国庆节”——会立刻在调休、闰年、农历节日（如春节、端午、中秋）上失败。
真正可行的路径只有两条：查表或调用外部服务。国内绝大多数生产系统选择前者，因为稳定、离线、可控。
推荐做法：用预置 JSON 表 + 简单解析逻辑
国家节假日安排由国务院每年年底发布次年安排，实际落地时需人工整理为结构化数据。建议维护一个轻量级 holidays.json，内容类似：
{
"2024": {
"holiday": ["2024-01-01", "2024-02-10", "2024-02-11", ...],
"workday": ["2024-02-03", "2024-02-04", ...]
}
}
解析后存入 std::unordered_set<:string></:string> 或 std::map<year std::set>></year>，查询时拼接 "YYYY-MM-DD" 字符串即可比对。
-
std::string格式统一用"%Y-%m-%d"（用std::put_time或fmt::format生成），避免"2024/1/1"这类变体引发漏判 - 务必同时加载
"workday"列表：调休上班日不是节假日，但也不算周末，必须显式排除 - 若需支持跨年范围（如查 2023–2025），提前把三年数据都载入内存，别每次查都读文件
遇到农历节日怎么办？别自己写农历转换
春节、端午、中秋等日期每年变动，依赖农历计算极易出错（涉及闰月、节气、朔望等复杂规则）。已有成熟、经验证的 C++ 封装库可用：
- 用
lunisolar（GitHub 开源小库）：提供lunisolar::solar_to_lunar()和lunisolar::lunar_to_solar()，输入公历日期可得农历年月日，再查表比对“正月初一”“五月初五”等 - 更稳妥的做法仍是查表：直接把未来 5–10 年所有春节/端午/中秋的公历日期列出来，和元旦、国庆一样平权处理——国务院公告里本来就是给的公历日期
- 避免用 Python 的
cnlunar或 JS 的chinese-lunar-calendar通过 FFI 调用：增加依赖、跨语言边界易崩溃、时区处理更混乱
线上服务要不要自己部署节假日 API？
如果业务对时效性要求极高（例如抢票系统需实时响应当年刚发布的调休通知），可考虑封装一个极简 HTTP 客户端去请求公开节假日 API（如 https://api.apihubs.cn/holiday/2024），但必须加本地 fallback：
- 首次启动时下载并缓存最新 JSON 到本地磁盘（如
/var/lib/app/holidays.cache） - 每次查询优先读缓存；HTTP 请求设 2 秒超时 + 重试 1 次；失败则降级用缓存数据
- 禁止在关键路径（如支付校验）中同步等待网络响应——节假日判断必须是微秒级完成的本地操作
真正的难点从来不在代码怎么写，而在于谁来持续更新那张表、如何验证今年春节初一没被标成初二、以及调休列表里那个“2024-02-04 周一上班”到底该不该算进 workday 集合——这些都不是编程问题，是运营责任。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
