# vsme/chinese-days

中国法定节假日、调休和工作日、24节气查询，农历阳历互转，提供 JSON 文件，对非开发者，还提供 iCal 日历订阅，可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端使用。

Repository: https://github.com/vsme/chinese-days
Canonical: https://ross.abutalabs.com/products/chinese-days
Homepage: https://chinese-days.yaavi.me
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-07-07T02:43:31+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 91, release rhythm 86, longevity 59
- inputs: {"age_days": 839, "days_push": 57, "days_rel": 92, "gap_med": 20, "n_releases_24m": 12}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1274, forks 59 (observed 2026-08-28T04:04:12.773671+00:00)

## What it is
A TypeScript/npm library for querying Chinese statutory holidays, adjusted workdays (调休), regular workdays, and the 24 solar terms, plus lunar-to-solar calendar conversion covering 1900-2100. It also ships JSON data files for non-JS languages and iCal (.ics) subscription feeds that work with Google Calendar, Apple Calendar, and Microsoft Outlook.

## Use cases
- check whether a given date is a Chinese public holiday or a workday
- determine adjusted working days (调休) around Chinese holidays
- convert between lunar (阴历) and solar/gregorian calendar dates
- look up the 24 solar terms (节气) for a given date
- subscribe to Chinese holidays in Google Calendar, Apple Calendar, or Outlook
- consume Chinese holiday data as JSON from a non-JavaScript language like Java
- add Chinese holiday awareness to a scheduling or payroll feature

## When to choose
- you are building a JavaScript/TypeScript application that needs China holiday, workday, or lunar calendar logic
- you want an auto-updated holiday dataset that tracks State Council announcements via automated PRs
- you need ready-made iCal feeds or CDN-hosted JSON for calendar apps or non-JS projects

## When to avoid
- you need holiday data for countries or regions other than China
- you need general-purpose date parsing and manipulation rather than holiday/calendar specifics (use dayjs or date-fns)
- you need statutory holiday data before 2004, since holiday coverage starts in 2004

## Facets
- artifact type: library
- maturity: active
- function: date-time, json
- domain: developer-tools
- platform: browser, cross-platform
- tags: chinese-holidays, lunar-calendar, solar-terms, ical-calendar, calendar-subscription, workday-check, adjusted-workdays, chinese-lunar-calendar, localization, nodejs

## Member repositories
- vsme/chinese-days (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:12.773671+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-30T05:03:09.742523+00:00, confidence not recorded.
  - readme: https://github.com/vsme/chinese-days (fetched 2026-08-28T04:04:12.773671+00:00, sha 09958b2e6560)
  - homepage: https://chinese-days.yaavi.me (fetched 2026-08-29T12:14:23.047791+00:00, sha 4ce5b4b0163e)
  - site_page: https://chinese-days.yaavi.me/guide/getting-started.html (fetched 2026-08-29T12:14:23.050114+00:00, sha 4f58f5d988d0)
  - registry_npm: https://registry.npmjs.org/chinese-days (fetched 2026-08-29T12:14:23.051760+00:00, sha 7f9a0468c751)
- Data as of 2026-08-30T08:39:29.467469+00:00.