# NateScarlet/holiday-cn

📅🇨🇳中国法定节假日数据 自动每日抓取国务院公告

Repository: https://github.com/NateScarlet/holiday-cn
Canonical: https://ross.abutalabs.com/products/holiday-cn
Language: Python
License: MIT
License Family: permissive
Topics: data, natural-language-processing, crawling, holiday, china
Last push: 2026-08-19T20:00:01+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 39, longevity 100
- inputs: {"age_days": 2738, "days_push": 14, "days_rel": 244, "gap_med": 92.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2105, forks 211 (observed 2026-08-28T04:06:13.851252+00:00)

## What it is
A machine-readable dataset of China's official statutory holidays, automatically scraped daily from State Council announcements and published as JSON and ICalendar files. Updates are automated via CI with new releases whenever the data changes.

## Use cases
- check if a date is a Chinese public holiday
- get China holiday calendar for a given year as JSON
- subscribe to Chinese holidays in my calendar app via ics
- build a workday scheduler that respects Chinese statutory holidays
- automatically stay up to date with China holiday changes each year
- use China holiday data as a git submodule in my project

## When to choose
- you need authoritative China statutory holiday data sourced from State Council announcements
- you want JSON or ICS files consumable over CDN or as a git submodule
- you need automatically updated data with release notifications

## When to avoid
- you need holidays for countries other than China
- you need historical weekend-adjustment data beyond what State Council documents define
- you require a library API rather than raw data files

## Facets
- artifact type: dataset
- maturity: active
- function: data-science, date-time, web-scraping
- domain: data-science
- platform: cross-platform, cli
- tags: chinese-holidays, public-holidays, -dataset, icalendar, state-council-announcements, auto-updated, automation, localization, china, web-server

## Member repositories
- NateScarlet/holiday-cn (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:13.851252+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-30T02:54:01.124823+00:00, confidence not recorded.
  - readme: https://github.com/NateScarlet/holiday-cn (fetched 2026-08-28T04:06:13.851252+00:00, sha 197f69b518e4)
- Data as of 2026-08-30T08:39:29.467469+00:00.