使用须知

联系方式

近期更新 -- 更新企业微信日历订阅 2026-03-26 18:40:50

常见问题

限额说明及规则

API接口说明文档

苹果设备订阅法定节假日 - ICS


苹果官方已有中国法定节假日订阅，非必要不建议订阅本站日历，因为本站日历中包含24节气、其它节气及民俗节日等信息。
个人日历功能因考虑到垃圾日历、广告网址等问题，停止注册使用，后续只允许邀请用户及付费用户使用。也只可以只订阅本站默认的万年历，该订阅无需注册即可订阅。



BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//AILCC//Chinese Holiday API//CN
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-APPLE-CALENDAR-COLOR:#FF3333
X-WR-CALNAME:中国法定节假日

BEGIN:VEVENT
UID:0da98bb11fe3f47c6b25c43014668bb6@ailcc.com
DTSTART;VALUE=DATE:20250101
DTEND;VALUE=DATE:20250101
SUMMARY:元旦（休）
DESCRIPTION:元旦（休）
END:VEVENT

BEGIN:VEVENT
UID:395865170ccabb58554e436e264fd40b@ailcc.com
DTSTART;VALUE=DATE:20250201
DTEND;VALUE=DATE:20250201
SUMMARY:春节（休）
DESCRIPTION:春节（休）
END:VEVENT

END:VCALENDAR

📱 订阅方式：


获取指定日期的节假日信息 - info


{
  "code": 0,                                    // 0服务正常。-1服务出错
  "type": { 
    "type": enum(0, 1, 2, 3，4),                // 节假日类型，分别表示 工作日、周末、节日、调休放假、补班。
    "name": "国庆节（休）",                     // 节假日类型中文名，可能值为 周一 至 周日、假期的名字、某某调休。
    "week": 3                                   // 一周中的第几天。值为 1 - 7，分别表示 周一 至 周日。
    "cnLunar": "八月初十",                      // 农历
    "extra_info": "国庆节",                     // 其它节气
    "name_en": "National Day of China",         // name字段的节假日英文名称
    "extra_en": "National Day of China"         // extra_info字段的节假日英文名称
  },
  "holiday": {
    "holiday": true,                            // true表示是节假日，false表示是调休。
    "name": "国庆节（休）",                     // 节假日的中文名。如果是调休，则是调休的中文名，例如“国庆节（休）”。
    "wage": 3,                                  // 薪资倍数，1表示是1倍工资，该数据不再详细维护。
    "date": "2025-10-01",                       // 查询的时间参数。
    "after": null,                              // 只在调休或补班下有该字段。1表示假后调休或补班，0表示假前调休或补班，否则为null。
    "target": "国庆节",                         // 只在调休下有该字段。表示调休的节假日，否则为null。
    "rest": 39                                  // 表示当前时间距离目标还有多少天。
    "name_en": "National Day of China"          // name字段的节假日英文名称
  }
}

示例：


批量查询指定日期节假日信息 - batch


{
  "code": 0,                                // 0服务正常。-1服务出错
  "holiday": {                              // 传过来的日期是什么，key就是什么。传多少个就有多少个。
    "2025-09-9": null,                      // 如果不是节假日，则为null
    "2025-10-08": {                         // holiday的值都是一致的
      "holiday": true,                      // true表示是节假日，false表示是调休。
      "name": "国庆节（休）",               // 节假日的中文名。如果是调休，则是调休的中文名，例如“国庆节（休）”。
      "wage": 1,                            // 薪资倍数，1表示是1倍工资，该数据不再详细维护。
      "date": "2025-10-08",                 // 查询的时间参数。
      "rest": 1,                            // 表示当前时间距离目标还有多少天。
      "name_en": "National Day of China"    // name字段的英文名称
    }
  },
  "type": {                                 // 只有明确指定参数 type=Y 时才返回类型信息
    "2025-09-9": {                          // 一一对应holiday对象的key，holiday有多少个这里就有多少个
      "type": enum(0, 1, 2, 3，4),          // 节假日类型，分别表示 工作日、周末、节日、调休放假、补班。
      "name": "周二",                       // 节假日类型中文名，可能值为 周一 至 周日、假期的名字、某某调休。
      "week": 1                             // 一周中的第几天。值为 1 - 7，分别表示 周一 至 周日。
      "cnLunar": "七月十八",                // 农历
      "extra_info": "",                     // 其它节气，一般为空
      "name_en": "Tuesday"                  // name字段的英文名称
    },
    "2025-10-08": {
      "type": 2,
      "name": "国庆节（休）",
      "week": 3
      "cnLunar": "八月十七",
      "extra_info": "寒露",
      "name_en": "National Day of China",   // name字段的英文名称
      "extra_en": "Cold Dew"                // extra_info字段的英文名称
    }
  }
}

示例：


获取指定日期的下一个节假日（如果在放假前有调休，也会返回）- next


{
  "code": 0,                                // 0服务正常。-1服务出错。
  "holiday": {
    "holiday": true,                        // 该字段一定为true。
    "name": "国庆节（休）",                 // 节假日的中文名。
    "wage": 3,                              // 薪资倍数，3表示是3倍工资，该数据不再详细维护。
    "date": "2025-10-01",                   // 节假日的日期。
    "cnLunar": "八月初十",                  // 农历。
    "rest": 4,                              // 表示当前时间距离目标还有多少天。
    "name_en": "National Day of China"      // name字段的英文名称
  },
  "workday": {                              // 如果节假日前没调休，则此字段为null。
    "holiday": false,                       // 此字段一定为false。
    "name": "国庆节（班）",                 // 调休的中文名。
    "after": null,                          // 只在调休或补班下有该字段，1表示假后调休或补班，0表示假前调休或补班，否则为null。
    "wage": 1,                              // 薪资倍数，3表示是3倍工资，该字段不在详细维护。
    "target": "国庆节",                     // 表示调休的节假日。
    "date": "2025-09-28",                   // 表示要调休的日期。
    "rest": 1,                              // 表示当前时间距离目标还有多少天。
    "name_en": "National Day of China"      // name字段的英文名称
  },
  "type": {                                 // 只有明确指定参数 type=Y 时才返回类型信息。
    "holiday": {                            // 对应 holiday 中的日期类型，只有返回 holiday 信息时才存在此日期类型。
      "type": enum(0, 1, 2, 3，4),          // 节假日类型，分别表示 工作日、周末、节日、调休放假、补班。
      "name": "国庆节（休）",               // 节假日类型中文名，可能值为 周一 至 周日、假期的名字、某某调休。
      "week": enum(1 - 7)                   // 一周中的第几天。值为 1 - 7，分别表示 周一 至 周日。
      "cnLunar": "八月初十",                // 农历
      "extra_info": "",                     // 其它节气，一般为空
      "date": "2025-10-01",                 // 当天时间
      "name_en": "National Day of China"    // name字段的英文名称
    },
    "workday": {                            // 对应 workday 中的日期类型，只有返回 workday 信息时才存在此日期类型
      "type": enum(0, 1, 2, 3，4),          // 节假日类型，分别表示 工作日、周末、节日、调休放假、补班。
      "name": "国庆节（班）",               // 节假日类型中文名，可能值为 周一 至 周日、假期的名字、某某调休。
      "week": 7                             // 一周中的第几天。值为 1 - 7，分别表示 周一 至 周日。
      "cnLunar": "八月初七",                // 农历
      "extra_info": "",                     // 其它节气，一般为空
      "date": "2025-09-28",                 // 当天时间
      "name_en": "National Day of China"    // name字段的英文名称
    }
  }
}

示例：


获取指定日期的下一个工作日（工作日包含正常工作日、调休）不包含当天 - nextWorkday


{
  "code": 0,                                // 0服务正常。-1服务出错
  "workday": {                              // 如果没有查找到最近的工作日，则此字段为null。最大查找长度为30
    "type": enum(0, 1, 2, 3，4),            // 节假日类型，分别表示 工作日、周末、节日、调休放假、补班。
    "name": "工作日",                       // 工作日类型中文名，可能值为 周一 至 周五、某某调休。
    "week": 4,                              // 一周中的第几天。值为 1 - 7，分别表示 周一 至 周日。
    "date": "2025-10-09",                   // 表示要工作的日期。
    "rest": 8                               // 表示当前时间距离目标还有多少天。
    "extra_info": "",                       // 其它节气，一般为空
    "name_en": "Thursday"                   // name字段英文名称
  }
}

示例：


获取指定年份或年月份的所有节假日信息 - year


{
  "code": 0,                                // 0服务正常。-1服务出错
  "holiday": {
    "10-01": {
      "holiday": true,                      // 该字段一定为true
      "name": "国庆节（休）",               // 节假日的中文名。
      "wage": 3,                            // 薪资倍数，3表示是3倍工资，该数据不再详细维护。
      "date": "2025-10-01",                 // 节假日的日期
      "cnLunar": "八月初十",                // 农历
      "extra_info": "国庆节",               // 其它节气，一般为空
      "rest": 39,                           // 表示当前时间距离目标还有多少天。
      "name_en": "National Day of China",   // name字段英文名称
      "extra_en": "National Day of China"   // extra_info字段英文名称
    },
    "10-02": {
      "holiday": true,
      "name": "国庆节（休）",
      "wage": 3,
      "date": "2025-10-02",
      "cnLunar": "八月十一",
      "extra_info": "",
      "rest": 40,
      "name_en": "National Day of China"
    }
  }
  "type": {                                 // 只有明确指定参数 type=Y 时才返回类型信息
    "2025-10-01": {                         // 一一对应holiday对象的key，holiday有多少个这里就有多少个
      "type": enum(0, 1, 2, 3，4),          // 节假日类型，分别表示 工作日、周末、节日、调休放假、补班。
      "name": "国庆节（休）",               // 节假日类型中文名，可能值为 周一 至 周日、假期的名字、某某调休。
      "week": enum(1 - 7)                   // 一周中的第几天。值为 1 - 7，分别表示 周一 至 周日。
      "cnLunar": "八月初十",                // 农历
      "extra_info": "国庆节",               // 其它节气，一般为空
      "name_en": "National Day of China",   // name字段英文名称
      "extra_en": "National Day of China"   // extra_info字段英文名称
    },
    "2025-10-02": {
      "type": 2,
      "name": "国庆节（休）",
      "week": 4
      "cnLunar": "八月十一",
      "extra_info": "",
      "name_en": "National Day of China"
    },
    "2025-10-03": {
      "type": 2,
      "name": "国庆节（休）",
      "week": 5
      "cnLunar": "八月十二",
      "extra_info": "",
      "name_en": "National Day of China"
    },
  }
}

示例：


获取指定年份里每天的信息 - allyear


{
  "code": 0,                                // 返回码，0服务正常。-1服务出错
  "year": "2026",                           // 查询的年份（YYYY）
  "count": 365,                             // 当年天数（平年 365，闰年 366）
  "data": [
    {
      "date": "2026-01-01",                 // 日期（YYYY-MM-DD）
      "type": enum(0, 1, 2, 3，4),          // 节假日类型，分别表示 工作日、周末、节日、调休放假、补班。
      "is_holiday": 1,                      // 是否为休息日，1 = 放假（周末 / 法定节假日 / 调休），0 = 工作日（含补班）
      "name": "元旦节（休）",               // 节假日的中文名。如果是调休，则是调休的中文名，例如“国庆节（休）”。
      "wage": 1,                            // 薪资倍数，3表示是3倍工资，该数据不再详细维护。
      "after": null,                        // 只在调休或补班下有该字段。1表示假后调休或补班，0表示假前调休或补班，否则为null。
      "week": 4,                            // 一周中的第几天。值为 1 - 7，分别表示 周一 至 周日。
      "target": "元旦节",                   // 只在调休下有该字段。表示调休的节假日，否则为null。
      "lunar": "冬月十三",                  // 农历
      "extra_info": "元旦节",               // 其它节气，一般为空
      "name_en": "New Year's Day",          // name字段英文名称
      "extra_en": "New Year's Day"          // extra_info字段英文名称
    },
    {
      "date": "2026-01-02",
      "type": 2,
      "is_holiday": 1,
      "name": "元旦节（休）",
      "wage": 1,
      "after": null,
      "week": 5,
      "target": "元旦节",
      "lunar": "冬月十四",
      "extra_info": "",
      "name_en": "New Year's Day"
    },
    {
      "date": "2026-01-03",
      "type": 2,
      "is_holiday": 1,
      "name": "元旦节（休）",
      "wage": 1,
      "after": null,
      "week": 6,
      "target": "元旦节",
      "lunar": "冬月十五",
      "extra_info": "",
      "name_en": "New Year's Day"
    },
    {
      "date": "2026-01-04",
      "type": 4,
      "is_holiday": 0,
      "name": "元旦节（班）",
      "wage": 1,
      "after": 1,
      "week": 7,
      "target": "元旦节",
      "lunar": "冬月十六",
      "extra_info": "",
      "name_en": "New Year's Day"
    },
    {
      "date": "2026-01-05",
      "type": 0,
      "is_holiday": 0,
      "name": "周一",
      "wage": 1,
      "after": null,
      "week": 1,
      "target": "",
      "lunar": "冬月十七",
      "extra_info": "小寒",
      "name_en": "Monday",
      "extra_en": "Lesser Cold"
    },
  ]
}

示例：


赞助本站—

长期维护一个网站的服务，对个人开发者来说，除掉运营费用，最难的就是耐心和坚持，(￣ー￣)。
本站该服务长期维护，并免费提供给大家使用。如果你觉得用的好，有钱的捧个钱场，没钱的捧个人场，尽量别大量无意义的调用就行了。
如果该服务对你有用，并打算长期使用，你可以赞助个1块、2、3的，当然10块也可以，但不要超过10块，有这钱自己留着买好吃的吧。
所有赞助的资金将用于该服务的服务器、流量、带宽、域名方面。
付款支持支付宝、微信，扫下方二维码，付款时请一定确认账号，赞助的金额无论大小，一律不退。
付款时请一定要写备注，或者你想对站长传达的话，谢谢。
有任何问题，请第一时间截图并发邮件给站长：jack.liu@ailcc.com

赞助记录
以下为赞助记录，按时间顺序展示，感谢每一位支持本站的朋友。

历史更新

查看完整历史更新