# jjonline/calendar.js

中国农历（阴阳历）和西元阳历即公历互转JavaScript库

Repository: https://github.com/jjonline/calendar.js
Canonical: https://ross.abutalabs.com/products/calendarjs
Language: JavaScript
License: GPL-3.0
License Family: copyleft
Last push: 2025-03-25T01:11:23+00:00

## Health v2 (maintenance only)
Score: 29/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 13, release rhythm 8, longevity 100
- inputs: {"age_days": 3113, "days_push": 527, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1053, forks 396 (observed 2026-08-28T04:03:23.621305+00:00)

## What it is
A small JavaScript library for converting between the Chinese lunar calendar and the Gregorian (solar) calendar. It also returns supplementary data such as heavenly stems and earthly branches (Gan-Zhi), zodiac animals, solar terms, and astrological signs.

## Use cases
- convert a Gregorian date to Chinese lunar date
- convert lunar date to solar date in JavaScript
- get Chinese zodiac animal for a birth year
- display lunar dates in a Chinese calendar app
- compute heavenly stems and earthly branches for a date
- find solar terms for a given lunar month

## When to choose
- you need lightweight lunar/Gregorian conversion in JavaScript without dependencies
- you want lunar calendar metadata like Gan-Zhi, zodiac, and solar terms
- you are building a Chinese-language app that shows traditional dates

## When to avoid
- you need calendars other than Chinese lunar and Gregorian
- you need a full-featured calendar UI component rather than a conversion library
- you need non-JavaScript language support

## Facets
- artifact type: library
- maturity: stable
- function: date-time, internationalization
- domain: developer-tools, web-development
- platform: browser, cross-platform
- tags: chinese-lunar-calendar, solar-lunar-conversion, calendar, gan-zhi, zodiac, localization, javascript, nodejs

## Member repositories
- jjonline/calendar.js (main) score 29

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:23.621305+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-30T06:59:21.866992+00:00, confidence not recorded.
  - readme: https://github.com/jjonline/calendar.js (fetched 2026-08-28T04:03:23.621305+00:00, sha 063a48fffcd8)
- Data as of 2026-08-30T08:39:29.467469+00:00.