liriansu-opus/chinese-calendar
判断一天是不是法定节假日/法定工作日（查看节假日安排） observed · 2026-08-28
Health v2 · maintenance only
67/100
- Activity 86
- Release rhythm 23
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-02. Adoption (stars, forks) is never an input.
- gap_med: 206.5
- age_days: 3377
- days_rel: 302
- days_push: 88
- n_releases_24m: 3
Adoption not part of the score
1369 stars · 206 forks observed · 2026-08-28
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-08-28 · 6d5408994c91
- homepage: https://pypi.org/project/chinesecalendar/ · fetched 2026-08-29 · 4b4e8fead74a
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| liriansu-opus/chinese-calendar | main | 67 |
For agents
markdown · JSON · MCP: product_card(name="liriansu-opus/chinese-calendar")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem