logo logo
公告
中国法定节假日免费API 提供权威的节假日数据接口,轻松集成到你的系统中。
苹果设备订阅法定节假日 - ICS 苹果官方已有中国法定节假日订阅,非必要不建议订阅本站日历,因为本站日历中包含24节气、其它节气及民俗节日等信息。
获取指定日期的节假日信息 - info 指定日期的字符串,格式 ‘2025-10-01’,可以省略,则默认服务器的当前时间。
批量查询指定日期节假日信息 - batch 指定日期的字符串,多个日期之间使用且只能使用英文逗号“,”连接。最大长度查询个数31,多余日期不返回,日期格式 ‘2025-10-01’。
工单反馈系统 - 精准 · 权威 · 实时 所以工单必须通过审核后才会显示,无意义工单将会无通知删除。
稳定 · 准确 · 实时· 免费 同步官方公告数据,确保数据的准确性。
为开发者而生 提供 RESTful JSON API,响应快速,结构清晰。

中国法定节假日 API

提供正确、精准、稳定、实时更新的中国法定节假日数据服务,支持节假日查询、工作日判断、调休安排查询、节日信息获取等多种场景。

累计调用 ↻ 每24小时更新

法定节假日

直观查看中国法定节假日、调休安排及农历信息,点击日期可查看详情

为什么接受赞助捐赠?

❤️

“中国法定节假日 API”从诞生之初,就不是一个以盈利为目的的商业项目,而是希望为开发者、小型企业和个人提供一个稳定、准确、永久免费的中国法定节假日查询服务。

我们所提供的法定节假日数据,均依据国务院办公厅发布的节假日安排通知及其他官方公开信息进行整理和维护,不对官方通知内容进行修改,仅将其转换为便于程序调用的标准化数据接口,并确保准确无误。
如官方发布内容发生调整或补充,我们将尽快同步更新相关数据;最终安排请以官方最新发布的通知为准。
随着项目的使用量增长,服务器、域名、带宽等日常维护成本持续增加,目前这些费用主要由项目自行承担,为了让项目长期稳定运行,未来我们可能会尝试一些能够覆盖运营成本的方式,让项目能够长期稳定地运行下去,但初心永远不会改变。

🛡️ 我们的长期承诺:

  • 纯净无广告:绝不在 API 返回数据中插入广告、跟踪代码或无关内容。
  • 绝不强制绑定:不会要求设置主页,也不会强制安装任何软件。
  • 专注核心体验:不搞套路,始终专注于提供可靠的免费节假日数据。

如果您认可这个项目,觉得它切实帮助到了您的工作或学习,欢迎通过自愿赞助的方式支持我们。每一份支持,都将直接用于服务器、网络资源以及项目的持续维护,让更多开发者能够继续免费使用这项服务。

接口调用概览

展示各接口累计调用量情况,数据每24小时更新一次

🔍 year
1772266
累计调用
↻ 每24小时更新
📅 info
788695
累计调用
↻ 每24小时更新
📅 ics
191140
累计调用
↻ 每24小时更新
🔍 allyear
187465
累计调用
↻ 每24小时更新
📅 当天个人日历
126348
累计调用
↻ 每24小时更新
📅 tts 高级API
117541
累计调用
↻ 每24小时更新
📦 batch
104923
累计调用
↻ 每24小时更新
📅 个人日历
8662
累计调用
↻ 每24小时更新
📅 nextWorkday
4103
累计调用
↻ 每24小时更新
⏰ next
3854
累计调用
↻ 每24小时更新

核心特性

API 提供中国法定节假日与调休信息,支持年份查询、日期查询、批量请求,助力各类应用快速接入。

🚀 高性能

基于缓存与索引优化,毫秒级响应。

📅 多维度数据

返回节日名、日期、类型、工资倍数、是否放假等字段。

🧠 智能更新

自动跟随国务院节假日公告更新,无需手动维护。

🛡️ 纯净免费

坚持免费、纯净无广告。无套路,无跟踪代码,只为给开发者提供一个靠谱、稳定的公共服务。

接口调用示例

                GET https://holiday.ailcc.com/api/holiday/year/2026

Response:
{
  "code": 0,
  "version": 1,
  "holiday": {
    "01-01": {
      "holiday": true,
      "name": "元旦节(休)",
      "wage": 3,
      "date": "2026-01-01",
      "cnLunar": "冬月十三",
      "cnLunarYear": "乙巳",
      "cnAnimal": "蛇",
      "extra_info": "元旦节",
      "rest": 0
    },
    "01-02": {
      "holiday": true,
      "name": "元旦节(休)",
      "wage": 2,
      "date": "2026-01-02",
      "cnLunar": "冬月十四",
      "cnLunarYear": "乙巳",
      "cnAnimal": "蛇",
      "extra_info": "",
      "rest": 0
    },
    "01-03": {
      "holiday": true,
      "name": "元旦节(休)",
      "wage": 2,
      "date": "2026-01-03",
      "cnLunar": "冬月十五",
      "cnLunarYear": "乙巳",
      "cnAnimal": "蛇",
      "extra_info": "",
      "rest": 0
    },
    "02-15": {
      "holiday": true,
      "name": "春节(休)",
      "wage": 2,
      "date": "2026-02-15",
      "cnLunar": "腊月廿八",
      "cnLunarYear": "乙巳",
      "cnAnimal": "蛇",
      "extra_info": "",
      "rest": 0
    },
    ······
  }
}