china-holidays-extra

中国节假日补充日历

补充 iOS / macOS 系统自带「中国节假日」订阅中缺少的公共节日。

背景

Apple 官方的中国节假日订阅已覆盖春节、清明、劳动节、端午、中秋、国庆等传统节日，但缺少了许多公众普遍关注的节日，例如：

• 母亲节、父亲节、感恩节
• 情人节、平安夜、圣诞节
• 万圣节、愚人节
• 妇女节、青年节、教师节 等

本项目提供一份标准的 .ics 日历文件，可直接导入 iPhone、iPad、Mac 的日历应用，或作为 CalDAV/WebCal 订阅源长期使用。

包含节日

固定日期（每年自动重复）

节日	日期
情人节	2 月 14 日
妇女节	3 月 8 日
植树节	3 月 12 日
愚人节	4 月 1 日
青年节	5 月 4 日
教师节	9 月 10 日
万圣节	10 月 31 日
平安夜	12 月 24 日
圣诞节	12 月 25 日

农历节日（预计算未来 11 年，iOS 官方订阅中通常缺失）

节日	农历日期
龙抬头	二月初二
上巳节	三月初三
中元节	七月十五
腊八节	腊月初八
小年	腊月廿三

注：春节、元宵、清明、端午、七夕、中秋、重阳、除夕等主流农历节日，iOS 官方「中国节假日」订阅已包含，本项目不再重复添加，避免日历中出现重复提醒。

浮动日期（按规则每年自动计算）

节日	规则
母亲节	5 月第二个星期日
父亲节	6 月第三个星期日
感恩节	11 月第四个星期四

使用方法

方式一：直接导入（推荐一次性使用）

1. 下载 china-holidays-extra.ics 文件
2. 通过 AirDrop、微信、邮件等方式发送到 iPhone/iPad/Mac
3. 点击文件，选择「添加全部」到日历

方式二：URL 订阅（推荐，可自动同步更新）

如果你将本项目部署在静态托管服务（如 GitHub Pages）上，可以直接订阅远程文件：

https://<your-domain>/china-holidays-extra.ics

iOS / iPadOS 操作步骤：

1. 打开「设置」→「日历」→「账户」→「添加账户」→「其他」→「添加已订阅的日历」
2. 在「服务器」中输入上述 .ics 文件的完整 URL
3. 点击「下一步」→「存储」

macOS 操作步骤：

1. 打开「日历」应用
2. 菜单栏选择「文件」→「新建日历订阅」
3. 输入 .ics 文件的完整 URL，点击「订阅」

订阅后，若文件内容更新，客户端会自动同步最新节日数据。

文件说明

文件	说明
china-holidays-extra.ics	标准 iCalendar 格式的日历文件，符合 RFC 5545 规范
generate_ics.py	生成/更新 ics 文件的辅助脚本

技术细节

• 所有节日均使用 RRULE 规则实现每年自动重复，无需手动更新固定日期节日
• 浮动日期节日（母亲节、父亲节、感恩节）使用 BYMONTH + BYDAY 组合规则自动匹配每年正确日期
• 事件设置为全天事件（VALUE=DATE），不会在日历中占用具体时间段
• 事件透明度设为 TRANSPARENT，不会显示为忙碌状态
• 农历节日采用 RDATE 机制：通过 zhdate 库预计算未来 11 年（2025–2035）的公历对应日期，避免与 iOS 官方订阅重复
• 文件使用 UTF-8 编码，CRLF 换行，兼容 Apple 日历、Google 日历、Outlook 等主流客户端

自定义与扩展

如需添加或修改节日，可编辑 generate_ics.py 中的节日列表，然后重新运行：

# 依赖安装
pip install zhdate

# 生成/更新 ics
python3 generate_ics.py

脚本会自动重新生成 china-holidays-extra.ics。

许可

本项目采用 MIT License 开源许可。

This site is open source. Improve this page.