liriansu-opus/chinese-calendar
判断一天是不是法定节假日/法定工作日（查看节假日安排） observed · 2026-10-21
Health v2 · maintenance only
61/100
- Activity 78
- Release rhythm 16
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-10-21. Adoption (stars, forks) is never an input.
- gap_med: 356
- age_days: 3425
- days_rel: 350
- days_push: 136
- n_releases_24m: 2
Adoption not part of the score
1383 stars · 208 forks observed · 2026-10-21
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
A Python library that determines whether a given date is a Chinese statutory holiday or workday, based on the State Council's official holiday schedules. It covers 2004 through 2026 and can also identify holiday names and adjusted workdays (调休).
Use cases
- check if a date is a Chinese public holiday
- determine whether today is a legal workday in China
- get the holiday name for a given date
- detect if a holiday is a compensated day off (调休)
- schedule jobs only on Chinese workdays
- validate business-day logic for China-based applications
When to choose
- your Python application needs accurate Chinese statutory holiday and workday logic
- you need holiday names and in-lieu (调休) information, not just weekend checks
- you want a lightweight pip-installable data-driven calendar
When to avoid
- you need holidays for countries other than China
- you need dates beyond the supported range before the annual State Council announcement is published
- you need a runtime-updating holiday API rather than a versioned data package
Facets
library · maturity active
date-time sdk developer-tools python cross-platform chinese-holidays public-holidays workdays calendar china localization
2 sources
- readme: https://github.com/liriansu-opus/chinese-calendar · fetched 2026-10-21 · 6d5408994c91
- homepage: https://pypi.org/project/chinesecalendar/ · fetched 2026-08-29 · 4b4e8fead74a
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| liriansu-opus/chinese-calendar | main | 61 |
For agents
markdown · JSON · MCP: product_card(name="liriansu-opus/chinese-calendar")
Data as of 2026-10-19T08:05:51.212177+00:00 · Report a problem