vsme/chinese-days
中国法定节假日、调休和工作日、24节气查询，农历阳历互转，提供 JSON 文件，对非开发者，还提供 iCal 日历订阅，可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端使用。 observed · 2026-08-28
Health v2 · maintenance only
83/100
- Activity 91
- Release rhythm 86
- Longevity 59
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: 20
- age_days: 839
- days_rel: 92
- days_push: 57
- n_releases_24m: 12
Adoption not part of the score
1274 stars · 59 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
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
library · maturity active
date-time json developer-tools browser cross-platform chinese-holidays lunar-calendar solar-terms ical-calendar calendar-subscription workday-check adjusted-workdays chinese-lunar-calendar localization nodejs
4 sources
- readme: https://github.com/vsme/chinese-days · fetched 2026-08-28 · 09958b2e6560
- homepage: https://chinese-days.yaavi.me · fetched 2026-08-29 · 4ce5b4b0163e
- site_page: https://chinese-days.yaavi.me/guide/getting-started.html · fetched 2026-08-29 · 4f58f5d988d0
- registry_npm: https://registry.npmjs.org/chinese-days · fetched 2026-08-29 · 7f9a0468c751
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| vsme/chinese-days | main | 83 |
For agents
markdown · JSON · MCP: product_card(name="vsme/chinese-days")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem