https://github.com/vsme/chinese-days

中国法定节假日、调休和工作日、24节气查询，农历阳历互转，提供 JSON 文件，对非开发者，还提供 iCal 日历订阅，可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端使用。
https://github.com/vsme/chinese-days

Last synced: 18 days ago
JSON representation

中国法定节假日、调休和工作日、24节气查询，农历阳历互转，提供 JSON 文件，对非开发者，还提供 iCal 日历订阅，可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端使用。

• Host: GitHub
• URL: https://github.com/vsme/chinese-days
• Owner: vsme
• License: mit
• Created: 2024-05-16T11:20:00.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2026-03-05T04:47:17.000Z (18 days ago)
• Last Synced: 2026-03-05T08:39:47.477Z (18 days ago)
• Language: TypeScript
• Homepage: https://chinese-days.yaavi.me
• Size: 3.17 MB
• Stars: 1,179
• Watchers: 7
• Forks: 55
• Open Issues: 2
• Metadata Files:
  • Readme: README.en.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - vsme/chinese-days - 中国法定节假日、调休和工作日、24节气查询，农历阳历互转，提供 JSON 文件，对非开发者，还提供 iCal 日历订阅，可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端使用。 (TypeScript)

README

          
# Chinese Days

[![NPM Version](https://img.shields.io/npm/v/chinese-days)](https://www.npmjs.com/package/chinese-days)

[![GitHub License](https://img.shields.io/github/license/vsme/chinese-days)](https://github.com/vsme/chinese-days/blob/main/LICENSE)

[![README](https://img.shields.io/badge/README-中文-brightgreen.svg)](https://github.com/vsme/chinese-days/blob/main/README.md)

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](https://chinese-days.yaavi.me/en/).

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](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](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](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](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](https://cdn.jsdelivr.net/npm/chinese-days/dist/chinese-days.json).

If you need a `JSON` file for a specific year, you can also reference it through this link: [years/2025.json](https://cdn.jsdelivr.net/npm/chinese-days/dist/years/2025.json).

For example, in `Java`, you can refer to [Warnier-zhang/java-chinese-days](https://github.com/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](https://github.com/vsme/chinese-days/blob/main/src/holidays/generate.ts);

3. Lunar definitions: Modify the [lunar definitions](https://github.com/vsme/chinese-days/blob/main/src/solar_lunar/constants.ts);

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](https://github.com/Bigkoo/Android-PickerView) project.

2. Chinese holiday data generation references the `Python` version of the [LKI/chinese-calendar](https://github.com/LKI/chinese-calendar) project.

3. Thank you for the recommendation from [Mr. Ruan Yifeng](https://github.com/ruanyf/weekly/blob/master/docs/issue-372.md#%E5%B7%A5%E5%85%B7).