分享一个可以替代“法定节假日 API”库

Yaavi · 2024-11-13 14:27:41 · 620 次点击

昨天已第一时间更新 2025 年法定节假日。

源码:https://github.com/vsme/chinese-days
Demo:https://chinese-days.yaavi.me/


GitHub License README

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

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

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

项目中的很多 API 主要针对于 TSJS 开发人员。

JS 语言

如果你不使用 TSJS 开发项目,本项目提供了中国节假日的 JSON 文件,通过链接 https://cdn.jsdelivr.net/npm/chinese-days/dist/chinese-days.json 可以直接引用。

日历订阅

在 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 年)的节假日和调休日。

API 使用

详细使用方式,可以看项目源码主页。

举报· 620 次点击
登录 注册 站外分享
5 条回复  
SimonOne 小成 2024-11-13 14:42:14
好。 可惜本质这个活就是没有算法的,依赖于放假办公室的决议,得人工或者机器爬(不能写死成固定离线计算的代码),所以依赖外部 api 的话得时刻防着 api 挂掉,不能无脑丢一边。😂
986244073 初学 2024-11-13 14:49:53
可以生成一个 2025 的日历吗
Yaavi 楼主 小成 2024-11-13 14:57:35
https://i.imgur.com/3VWdZdg.png @SimonOne AI 可以干这个活,在爬取之后,把文本丢给 AI 处理,去生成提交指定的代码就可以,不过从心理上还是会不太放心。
Yaavi 楼主 小成 2024-11-13 14:58:49
@986244073 日历在这里: https://chinese-days.yaavi.me/
xiaoxuan6 初学 2024-11-13 15:32:43
go 版本 [chinese-holidays-api]( https://github.com/xiaoxuan6/chinese-holidays-api) 支持 docker 部署
返回顶部