中国节假日

本项目提供了一系列用于查询中国节假日、调休日、工作日、24节气、以及农历阳历互转的函数，此外还支持 iCal 文件订阅节假日，可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端订阅。

文档

查看文档, 请访问 chinese-days.yaavi.me.

每日会执行 Action 自动抓取数据，节假日变化时发送邮件提醒，信息会跟随国务院发布进行更新。

• 节假日：支持 2004年 至 2025年，包括 2020年 的春节延长
• 24节气：支持 1900年 至 2100年。
• 农历日：支持 1900年 至 2100年。

非 JS 语言

如果你不使用 JS 或 TS 开发项目，本项目提供了中国节假日的 JSON 文件，通过链接 chinese-days.json 可以直接引用。

比如在 Java 中使用，可以参考 Warnier-zhang/java-chinese-days，仅用于查询中国节假日、调休日、工作日；

日历订阅

在 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端中，可以设置订阅地址：https://cdn.jsdelivr.net/npm/chinese-days/dist/holidays.ics 来获取日历订阅。

For English: https://cdn.jsdelivr.net/npm/chinese-days/dist/holidays.en.ics

订阅的日历包含近三年（2023-2025年）的节假日和调休日。

贡献代码

1. Fork + Clone 项目到本地；
2. 节假日: 修改 节假日定义；
3. 农历定义: 修改 农历定义；
4. 其他修改...；
5. 提交PR。

致谢

1. 农历数据来自于 Bigkoo/Android-PickerView 项目。
2. 中国节假日数据生成参考了 Python 版本的 LKI/chinese-calendar 项目。

CHANGELOG

1.5.0 (2025-01-24)

• 增加中国农历民俗节日与纪念日

1.4.0 (2024-11-21)

• 完善法定节假日的放假天数，比如 2007-05-01 法定节假日为 Labour Day,劳动节,3，2024-05-01 法定节假日为 Labour Day,劳动节,1，而 2025-05-01 为 Labour Day,劳动节,2，最后一个数字 3、1、2 对应每年法定节假日的精准放假天数。

1.3.4 (2024-11-13)

• 修正中秋节展示问题

1.3.3 (2024-11-12)

• 增加 2025 年节假日

1.3.2 (2024-11-05)

• 修复 getLunarDate 阴历闰月的第一天月份错误

1.3.1 (2024-06-15)

• 增加 iCal 英文版本订阅

1.3.0 (2024-06-15)

• 支持 iCal 文件订阅节假日，可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端订阅

1.2.4 (2024-06-03)

• 兼容 Safari 日期格式

1.2.3 (2024-05-30)

• 不在节假日范围内的日期不再抛出异常

1.2.2 (2024-05-29)

• 增加 getSolarTermsInRange 获取日期范围内节气

1.2.1 (2024-05-23)

• 优化代码
• 将导出内容作为命名导出

1.2.0 (2024-05-23)

特性

• 项目目录重构，代码逻辑更加清晰；
• 打包大小有所增加，为: 19.84 kB，gzip 压缩减小: 6.60 kB。

1.1.0 (2024-05-23)

特性

• 导出 JSON 文件，提供给非 JS 项目使用。

1.0.0 (2024-05-23)

• 1.0.0 版本正式发布。