# liriansu-opus/chinese-calendar

判断一天是不是法定节假日/法定工作日（查看节假日安排）

Repository: https://github.com/liriansu-opus/chinese-calendar
Canonical: https://ross.abutalabs.com/products/chinese-calendar
Homepage: https://pypi.org/project/chinesecalendar/
Language: Python
License: MIT
License Family: permissive
Topics: chinese-calendar, calendar, holidays, workdays, python, chinese-holiday, public-holidays
Last push: 2026-06-06T08:41:29+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 86, release rhythm 23, longevity 100
- inputs: {"age_days": 3377, "days_push": 88, "days_rel": 302, "gap_med": 206.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1369, forks 206 (observed 2026-08-28T04:04:31.823818+00:00)

## What it is
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
- artifact type: library
- maturity: active
- function: date-time, sdk
- domain: developer-tools
- platform: python, cross-platform
- tags: chinese-holidays, public-holidays, workdays, calendar, china, localization

## Member repositories
- liriansu-opus/chinese-calendar (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:31.823818+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:40:59.855326+00:00, confidence not recorded.
  - readme: https://github.com/liriansu-opus/chinese-calendar (fetched 2026-08-28T04:04:31.823818+00:00, sha 6d5408994c91)
  - homepage: https://pypi.org/project/chinesecalendar/ (fetched 2026-08-29T11:57:51.314578+00:00, sha 4b4e8fead74a)
- Data as of 2026-08-30T08:39:29.467469+00:00.