lanceliao / china-holiday-calender

**节假日、调休、补班日历，ICS格式，可供IPhone、Google Calendar、Outlook等客户端订阅，包含节假日API

**节假日补班日历

说明

2022~2024年**放假、调休和补班日历 更新时间2024-01-03 18:20:37

支持3种类型的日历

• holidayCal.ics 包含放假和调休
• holidayCal-HO.ics 仅包含放假
• holidayCal-CO.ics 仅包含调休

订阅地址

注：链接地址为完整日历，若仅需放假或调休日历，替换URL的日历名称即可

• 国内订阅地址(支持定制补班日程): https://www.shuyz.com/githubfiles/china-holiday-calender/master/holidayCal.ics
• jsDelivr订阅地址: https://cdn.jsdelivr.net/gh/lanceliao/china-holiday-calender/holidayCal.ics
• GitHub订阅地址(科学上网): https://raw.githubusercontent.com/lanceliao/china-holiday-calender/master/holidayCal.ics

JSON API

• https://www.shuyz.com/githubfiles/china-holiday-calender/master/holidayAPI.json
• https://raw.githubusercontent.com/lanceliao/china-holiday-calender/master/holidayAPI.json

特点

1. 节假日信息来自**政府网，一手信息、权威准确
2. 包含最近3年的节假日信息，机器人自动维护，更新及时
3. 日历标题包含放假、补班的天数信息
4. 日历标题包含放假、补班等关键字，方便脚本开发。例如使用iPhone的快捷指令应用编写工作日闹钟
5. 每个补班日程自动设置上班提醒，默认时间为09:00~18:00、提前一个小时提醒
6. 支持个性化定制补班日程的开始、结束时间和提醒时间(例如提前一天提醒)
7. 没有广告！！！

放假日程

日程表	详细信息

补班日程

日程表	详细信息

定制补班日程

支持指定补班日程的开始、结束时间和提醒时间，格式为：订阅地址?token=API密钥&compStart=上班时分秒&compEnd=下班时分秒&compAlarm=在开始时间点提前多少分钟提醒

例如补班时间为早上8.30到晚上8.30，提前15分钟提醒，则订阅地址为 https://www.shuyz.com/githubfiles/china-holiday-calender/master/holidayCal.ics?token=cb429c2a-81a6-4c26-8f35-4f4bf0c84b2c&compStart=083000&compEnd=203000&compAlarm=15

注意:

• 时间格式为24小时制的6位数字，个位补0，例如8点零5分表示为080500
• 最大可提前9999分钟提醒，所以提前几天也是可以的。例如compStart为0800，设定前一天早上8点提醒，则compAlarm为提前24小时x60=1440; 设定前一天晚上8点提醒，则compAlarm为提前12小时x60=720
• 补班日程可设置为全天事件，指定compStart=*并且compEnd=*即可
• 由于订阅功能需消耗服务器资源进行计算，如果影响到服务器的正常使用，则定制功能可能随时取消

定制补班日程表	详细信息

快捷指令应用

节假日查询	节假日闹钟
https://www.shuyz.com/shortcuts/holiday-query	https://www.shuyz.com/shortcuts/holiday-alarm

API 字段说明

节假日对象：

字段名	类型	描述
Name	字符串	节假日的名称。
StartDate	字符串	节假日的开始日期，格式为"YYYY-MM-DD"。
EndDate	字符串	节假日的结束日期，格式为"YYYY-MM-DD"。
Duration	整数	节假日的持续天数。
CompDays	字符串数组	补班日期的数组，格式为"YYYY-MM-DD"。
URL	字符串	放假通知的URL链接。
Memo	字符串	放假通知。

china-holiday-calender's Issues

建议加入非法定节假日，如母亲节等

非常感谢开发者提供如此方便的日历订阅
如果能提供很多需要提前准备礼物的节日如：母亲节，父亲节，教师节等
就更好了，谢谢！

24节气

作者您好，能不能把24节气添加上去呢？

Outlook订阅全天日历，显示错误

在Outlook中订阅日历时，使用订阅参数 compStart=*&compEnd=* 出现的日程为当天00:00

---

可能需要如下格式：

DTSTART;VALUE=DATE:20220129
DTEND;VALUE=DATE:20220129

Repo把Calendar打成Calender了

如题，我搜了一下发现没搜到，原来repo把calendar打错了

New Year's holiday adjustment information error(过年假日调休的信息是错误的)

建议将调班设置成全天行程

建议将调班设置成全天行程（All day event)

建议：在readme中增加快捷指令分享链接

快捷指令应用中的“节假日查询 | 节假日闹钟”看起来很不错，请问是否可以同时iCloud分享这两个快捷指令呢

提醒时间问题

请问, 这个提醒一小时前, 订阅成功后显示为 无 , 未显示 一小时前

24年春节补班序号错误

24年的春节补班的3天 的序号是不是错嘞？

没有json么

可以把连续日期合并吗

日历原始数据是通过接口获取的？还是通过公告文字转的？

节假日信息来自**政府网。
使用的是该网站的接口吗？如果是可以提供一下吗？

定制显示信息

大佬～自从有一天被工作日闹钟吵醒就来搜到了你这个日历
因为每个人的时间或者是其它一些不同的地方想要定制不知道能不能帮忙一起实现一下😂
我现在是基于你的又做了一次字符串替换

比如我的工作时间其实就不是9-18

非常感谢大佬的日历！

是否支持自定义一个日期的补班

自定义一个日期的补班，比如每个月最后一周周六都需要上班

在OutLook中，看到的假期是0:00-0:00的，而不是全天的

在OutLook中，看到的假期是0:00-0:00的，而不是全天的

其他日历显示的是全天：

我们的日历显示的是0:00-0:00：

**日历

定制补班时间的token如何获取

如上

你好，发现2023年春节假期被归到2022年里了，2022年的元旦假期被归到2023年了

问题ics文件：
https://raw.githubusercontent.com/lanceliao/china-holiday-calender/master/holidayCal.ics

• 2022.1.21 ~ 2022.1.27，实际应为2023.1.21 ~ 2023.1.27，即2023年春节假期（但2023年已有对应日程）
• 2022.1.1 ~ 2022.1.3，元旦假期缺失
• 2023.1.1、2023.1.2，日程重复了2遍，重复项实为2022年的元旦假期

政府公告：
http://www.gov.cn/zhengce/content/2022-12/08/content_5730844.htm

2022年放假计划已经出来啦😬

请问可以设置不提示吗

只是想知道假期是哪一天，不希望有提示打扰的情况，该如何去掉提醒呀？

查询未来半年放假调休快捷方式不ug xn q

iOS15.3，这个指令有没有什么特殊的配置方式。

能否支持仅订阅补班日历

现在很多日历客户端都提供了**节假日订阅，IPhone也新增了这一项，能不能提供参数配置订阅集合 [节假日|补班]

ics 文件

您好，请问下 ics 文件是一键导出的吗？能否分享下，感谢

2024年的假期出来了

能否出一版不带天数信息的

能否出一版不带天数信息的
字数太多，显示 不全很难受

现在是2022，我添加不上了

能标注哪天是节日吗？

例如 清明节
现在只显示 清明放假第1天 清明放假第2天 清明放假第3天
看不出哪天是清明节🤔
能具体标注哪天是节日吗？

验证失败，添加不了

手机端不行，系统iOS 15.4；Mac端可以。

通过Mac端添加的，手机端没有正常显示。

地址在Safari浏览器中不能正常打开。

使用python的ics模块解析时报ValueError: A VALARM must have at least one DESCRIPTION

报错信息：
ValueError: A VALARM must have at least one DESCRIPTION

gpt解释：
VALARM是iCalendar规范的一部分，用于定义一个闹钟组件。根据规范，VALARM必须至少包含一个DESCRIPTION属性。

如果你在解析.ics文件时遇到了ValueError: A VALARM must have at least one DESCRIPTION这个错误，那可能是因为你的.ics文件中的VALARM组件没有包含DESCRIPTION属性。

2023updates

希望可以新增2023的节假日～感谢up主

自动运行？

每次都要手点一下吗

需要一个只有上班没有放假事件的年度离线版本

能开源制作方法也很好。

Android原生也有法定工作日闹钟的需求，目前可以稳定通过日历无限通知实现，不用扯到闹钟上。

这样设置成有事项就提醒，没事项就没提醒了，所以不需要标注放假。

同时可能有自行请假等情况，需要删除特定日期的事件实现自定义，所以需要不会联网更新。

以前都是我设置成全年上班，再手动删除周末和节假日的，所以希望能提供个自动生成的方法。

2024年没有元宵节

如题

ios17不会在界面上显示班或者调休了2024年的

在谷歌日历中使用url导入，春节补班信息不正确

谷歌日历中使用url导入，github和jsDelivr的订阅地址都试过了，这个补班天数总是显示3天，很奇怪。

2022年的劳动节假期中-4月30日，5月3日没有假期提醒

感谢您的这个项目。
设备：iPhone 12
iOS版本：15.4 beta

---

问题详情：
检查了一下，缺少了4月30日和5月3日的提醒内容。
具体见录屏。
https://user-images.githubusercontent.com/26129403/152956389-21fc60e6-b29e-4de5-8537-f7c50ec46844.mp4

全天补班可以弄成all day event 么

要不然在month view下看不清，也容易被其他内容顶到后面去

week view下，也会有很多overlap不太友好

如何添加母亲节、父亲节等

如何添加母亲节、父亲节等

补班能否也显示为全天日程？

快捷指令怎么弄？

怎么部署时间自动化任务？求教程

订阅之后在苹果日历上没有标题，建议增加

订阅之后在苹果日历上没有标题，建议增加

如何在自己的服务器上搭建？

请问有详细教程吗？

建议补班默认全天日程。

建议补班的默认设置为全天日程吧，不是所有人的工作时间都是早上9点至下午6点。

问题反馈

订阅国内地址，2024年1月9日是除夕

_{Sent from PPHub}