在日常工作和生活中，掌握中国法定节假日、调休安排以及传统节气信息对于企业排班、考勤管理和个人日程规划都至关重要。对于开发者而言，将这些信息快速集成到应用或系统中，又往往面临数据零散、更新滞后的困扰。{Chinese Days}应运而生，提供完整、权威且可自动更新的中国节假日与节气数据，支持 JSON 文件与 iCal 订阅，让用户轻松实现数据同步，无需手动维护。
Chinese Days 是什么？
Chinese Days 是一款开源的中国节假日与节气查询工具，覆盖 2004 至 2026 年的节假日、调休及工作日信息，并支持农历与阳历互转，以及 24 节气查询（节气数据延展至 2100 年）。项目自动对接国务院发布，确保信息权威、及时更新。工具面向开发者提供 JSON 接口，便于系统集成，同时也为普通用户提供 iCal 日历订阅，实现主流日历客户端的自动同步。
网站地址：https://chinese-days.yaavi.me
核心功能
Chinese Days 的设计旨在为开发者和普通用户提供高效、可靠的节假日数据服务。适合应用开发、企业管理和个人日程同步场景。
- 节假日查询——提供全国法定节假日及调休安排，便于日程规划。
- 农历阳历互转——支持农历与公历日期转换，方便传统节日或特殊日期计算。
- 24 节气查询——获取每年 24 节气日期，用于文化、农业及生活习惯参考。
- JSON 数据接口——开发者可直接引用
chinese-days.json文件，实现快速集成。 - iCal 日历订阅——兼容 Google Calendar、Apple Calendar、Outlook 等主流日历客户端，自动同步更新。
- 多语言支持——提供中文版与英文版订阅地址，适合跨境团队使用。
- 自动化更新——通过 GitHub Actions 抓取国务院公告，假期调整自动提交更新并提醒用户。
使用场景
Chinese Days 适合各类需要中国节假日数据的场景，包括企业、开发者和个人用户。
| 人群/角色 | 场景描述 | 推荐指数 |
|---|---|---|
| 开发者 | 将节假日、调休及节气数据集成到网站或应用系统 | ★★★★★ |
| 企业 HR | 企业排班、考勤系统中自动获取节假日安排 | ★★★★☆ |
| 个人用户 | 将节假日和节气同步到 Google/Apple/Outlook 日历 | ★★★★☆ |
| 海外团队 | 了解中国节假日与文化节气安排 | ★★★☆☆ |
操作指南
新手可在 3 分钟内完成节假日数据订阅与集成：
- 访问官网或 GitHub 项目获取资源链接「立即使用」。
- 对开发者：下载
chinese-days.json并导入到项目中。 - 对普通用户：复制 iCal 订阅地址到 Google、Apple 或 Outlook 日历。
- 系统自动同步节假日及节气信息，无需手动更新。
- （注意事项：订阅前请确认日历客户端支持自动刷新功能；开发者集成时注意 JSON 文件路径正确性）
支持平台
Chinese Days 提供多平台兼容方案，用户可在 Web、iOS、Android、平板及主流日历客户端使用。JSON 文件适用于任意编程语言和系统环境，iCal 文件可直接导入主流日历应用，实现自动同步和更新。
产品定价
免费开源项目，用户可自由下载、引用和订阅。无需注册或付费，适合个人、企业及开发者使用。
常见问题
Q1：是否安全？
所有数据直接同步国务院节假日公告，源可靠且开源透明，不包含第三方广告或追踪。
Q2：是否收费？
完全免费，提供 JSON 接口和 iCal 订阅，无需付费或购买权限。
Q3：是否需要注册？
无需注册即可使用，订阅 iCal 或下载 JSON 即可。
Q4：是否支持跨平台？
支持 Google Calendar、Apple Calendar、Outlook 等主流客户端，同时兼容 Web、iOS、Android 系统。
Q5：节日数据会自动更新吗？
是的，项目通过 GitHub Actions 每日抓取最新公告并自动更新，保证订阅用户数据同步最新信息。
开发者小结
Chinese Days 以权威数据源和自动更新机制为核心，适合需要精确中国节假日、调休与节气信息的开发者、企业及个人用户。开发者可快速集成 JSON 接口或 iCal 日历订阅，轻松完成日程管理、考勤或文化活动安排。适合希望节省手动维护成本、确保信息准确的场景；不适合仅关注非中国地区节假日的用户。
相关文章
