Query Chinese statutory holidays, check if a date is a working day/holiday, and get holiday schedules. Use when the user asks about Chinese holidays, working days, statutory holidays, or needs to know if a specific date is a holiday in China. Supports queries like "Is tomorrow a holiday?", "When is Spring Festival?", "Is May 1st a working day?".
Query Chinese statutory holidays and working day status.
python scripts/holidays.py today
python scripts/holidays.py check 2025-01-01
python scripts/holidays.py list 2025
today — Check today's statusCheck if today is a working day, holiday, or weekend.
python scripts/holidays.py today
Output:
2025-01-01 (Wednesday)
Status: HOLIDAY - New Year's Day (元旦)
check <date> — Check specific dateCheck if a specific date is a working day or holiday.
python scripts/holidays.py check 2025-02-10
Output:
2025-02-10 (Monday)
Status: HOLIDAY - Spring Festival (春节)
list <year> — List all holidays in a yearList all statutory holidays for a given year.
python scripts/holidays.py list 2025
Output:
=== 2025 Chinese Statutory Holidays ===
1. New Year's Day (元旦)
2025-01-01
2. Spring Festival (春节)
2025-01-28 to 2025-02-04 (8 days)
3. Qingming Festival (清明节)
2025-04-04 to 2025-04-06 (3 days)
4. Labor Day (劳动节)
2025-05-01 to 2025-05-05 (5 days)
5. Dragon Boat Festival (端午节)
2025-05-31 to 2025-06-02 (3 days)
6. Mid-Autumn Festival (中秋节)
2025-10-06 (1 day, combined with National Day)
7. National Day (国庆节)
2025-10-01 to 2025-10-07 (7 days)
next — Find next holidayFind the next upcoming holiday.
python scripts/holidays.py next
Output:
Next holiday: Spring Festival (春节)
Date: 2025-01-28 to 2025-02-04
Days until: 15 days
| Code | Meaning |
|---|---|
| 0 | Working day |
| 1 | Weekend |
| 2 | Statutory holiday |
| 3 | Adjusted working day (调休) |
Holiday data is based on official announcements from the State Council of China (国务院办公厅). The script includes: