百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
C

chinese-days

> 编程语言
开源

中国法定节假日、调休和工作日、24节气查询,农历阳历互转,提供 JSON 文件,对非开发者,还提供 iCal 日历订阅,可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端使用。

1.3K stars0 点赞2 次浏览
访问官网GitHub

工具介绍

中国法定节假日、调休和工作日、24节气查询,农历阳历互转,提供 JSON 文件,对非开发者,还提供 iCal 日历订阅,可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端使用。

中国节假日

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

自动化

已集成 AI 自动更新节假日数据,节假日变化时会自动 PR、并发送邮件提醒审核。

参考PR:#31 自动更新 2025 年假期配置

文档

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

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

  • 节假日:支持 2004年 至 2026年,包括 2020年 的春节延长
  • 24节气:支持 1900年 至 2100年。
  • 农历日:支持 1900年 至 2100年。

非 JS 语言

如果你不使用 JS 或 TS 开发项目,本项目提供了中国节假日的 JSON 文件,通过链接 chinese-days.json 可以直接引用;如果需要按年份单独的 JSON 文件,也可以通过链接 years/2025.json 直接引用,支持 2004 及之后的年份。

比如在 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

订阅的日历包含近三年的节假日和调休日。

如果需要按年份单独的 ics 文件,也可以通过链接 https://cdn.jsdelivr.net/npm/chinese-days/dist/years/2025.ics 直接引用,英文版本为 https://cdn.jsdelivr.net/npm/chinese-days/dist/years/2025.en.ics,支持 2004 及之后的年份。

贡献代码

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

致谢

  1. 农历数据来自于 Bigkoo/Android-PickerView 项目。
  2. 中国节假日数据生成参考了 Python 版本的 LKI/chinese-calendar 项目。
  3. 感谢阮一峰大佬的推荐。

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

TypeScript

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言