中国节假日查询

中国节假日查询#

查询中国法定节假日安排，数据来自 timor.tech 免费接口（无需 Key，数据每年更新）。

用法#

python3 holidays.py                     # 今年节假日总览 + 距下个假期倒计时
python3 holidays.py 2026-05-01          # 某天是否放假/调休
python3 holidays.py --year 2027         # 指定年份节假日总览
python3 holidays.py --next              # 下个节假日详情 + 倒计时
python3 holidays.py --today             # 今天是什么日子

输出示例#

2026 年节假日总览：
01-01 元旦 放假
01-01 元旦 放假
02-17 春节 放假（除夕前一日调休上班 02-16）
...
距下个节假日：11-27 感恩节?（无）→ 最近为 10-01 国庆节已过，下一个 2027-01-01 元旦 还剩 62 天

机制#

• 数据源：https://timor.tech/api/holiday/year/<年份>（官方节假日数据，含 date / holiday / name / wage / after / target 字段）。
• wage==1 表示调休上班日；holiday==true 表示放假；after 表示调休补班日期。
• 纯 Python 标准库（urllib），无第三方依赖。

隐私与安全#

• 不收集任何个人信息；仅向 timor.tech 公共接口发起查询。
• 不含任何密钥或账号凭据。