GitHub/chinese-days
1
0
Fork 0
mirror of https://github.com/vsme/chinese-days.git synced 2026-02-18 00:28:29 +01:00
Code Issues Projects Releases Packages Wiki Activity
中国法定节假日、调休和工作日、24节气查询，农历阳历互转，提供 JSON 文件，对非开发者，还提供 iCal 日历订阅，可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端使用。 https://chinese-days.yaavi.me
179 commits 5 branches 20 tags 3.3 MiB
Find a file
Exact
Yaavi 3d2f1e2431 feat(薪资计算器): 添加多语言支持和暗黑模式适配 
- 新增中英文双语支持，通过URL参数切换语言
- 实现暗黑模式，自动同步VitePress主题设置
- 优化样式变量管理，增强可维护性
- 完善文档和侧边栏配置
2025-12-09 09:22:20 +08:00
.github/workflows style: 统一代码格式并添加代码规范工具 2025-10-15 11:23:41 +08:00
docs feat(薪资计算器): 添加多语言支持和暗黑模式适配 2025-12-09 09:22:20 +08:00
scripts fix(scripts): 改进节假日配置更新的正则表达式匹配 2025-11-04 18:22:52 +08:00
src Add additional holiday arrangements for 2026 2025-11-04 18:31:33 +08:00
test style: 统一代码格式并添加代码规范工具 2025-10-15 11:23:41 +08:00
.editorconfig style: 统一代码格式并添加代码规范工具 2025-10-15 11:23:41 +08:00
.eslintrc.js style: 统一代码格式并添加代码规范工具 2025-10-15 11:23:41 +08:00
.gitignore feat(holidays): 添加自动更新假期配置功能 2025-09-19 17:38:53 +08:00
.prettierignore style: 统一代码格式并添加代码规范工具 2025-10-15 11:23:41 +08:00
.prettierrc style: 统一代码格式并添加代码规范工具 2025-10-15 11:23:41 +08:00
CHANGELOG.md docs: 更新文档支持年份至2026年 2025-11-04 18:39:01 +08:00
jest.config.ts style: 统一代码格式并添加代码规范工具 2025-10-15 11:23:41 +08:00
LICENSE Initial commit 2024-05-16 19:20:01 +08:00
package-lock.json 1.5.4 2025-11-04 18:39:32 +08:00
package.json 1.5.4 2025-11-04 18:39:32 +08:00
README.en.md Enhance README with JSON file support detail 2025-11-07 11:01:17 +08:00
README.md Enhance README with JSON file support details 2025-11-07 10:56:30 +08:00
tsconfig.json feat: v0.1.0 2024-05-21 10:10:41 +08:00
vite.config.ts style: 统一代码格式并添加代码规范工具 2025-10-15 11:23:41 +08:00

README.en.md

Chinese Days

NPM Version GitHub License README

This project provides a series of functions for querying Chinese holidays, adjusted working days, working days, 24 solar terms, and converting between lunar and solar calendars. Provide JSON file, Additionally, it supports ics file subscription for holidays, which can be subscribed to by Google Calendar, Apple Calendar, Microsoft Outlook, and other clients.

Automation

AI-powered automatic holiday data updates have been integrated. When holiday schedules change, it will automatically create a PR and send email notifications for review.

Documentation

To check out docs, visit chinese-days.yaavi.me.

The holiday information will be updated according to the announcements from the State Council.

  • Holidays: Supports the years 2004 to 2026, including the extended Spring Festival of 2020.
  • 24 Solar Terms: Supports the years 1900 to 2100.
  • Lunar Days: Supports the years 1900 to 2100.

Subscribe to Calendar

The subscribed calendar includes holidays and adjusted working days for the past three years (2024-2026).

Subscription URL: https://cdn.jsdelivr.net/npm/chinese-days/dist/holidays.ics (default language is Chinese)

For English: https://cdn.jsdelivr.net/npm/chinese-days/dist/holidays.en.ics

If you need a ics file for a specific year, you can also reference it through this link: https://cdn.jsdelivr.net/npm/chinese-days/dist/years/2025.en.ics, and the Chinese version is https://cdn.jsdelivr.net/npm/chinese-days/dist/years/2025.ics.

For non-JS projects, you can use the JSON file

A JSON file of Chinese holidays is provided and can be directly referenced through this link: chinese-days.json.

If you need a JSON file for a specific year, you can also reference it through this link: years/2025.json.

For example, in Java, you can refer to Warnier-zhang/java-chinese-days, which is only for querying Chinese holidays, in-lieu days, and regular workdays.

Contributing

  1. Fork + Clone the project to your local machine;
  2. Holidays: Modify the holiday definitions;
  3. Lunar definitions: Modify the lunar definitions;
  4. For other modifications, refer to the source code yourself;
  5. Submit a PR.

Acknowledgements

  1. Lunar calendar data is sourced from the Bigkoo/Android-PickerView project.
  2. Chinese holiday data generation references the Python version of the LKI/chinese-calendar project.
  3. Thank you for the recommendation from Mr. Ruan Yifeng.