6tail/lunar-javascript
日历、公历(阳历)、农历(阴历、老黄历)、佛历、道历，支持节假日、星座、儒略日、干支、生肖、节气、节日、彭祖百忌、每日宜忌、吉神宜趋凶煞宜忌、吉神(喜神/福神/财神/阳贵神/阴贵神)方位、胎神方位、冲煞、纳音、星宿、八字、五行、十神、建除十二值星、青龙名堂等十二神、黄道黑道日及吉凶等。lunar is a calendar library for Solar and Chinese Lunar. observed · 2026-08-28
Health v2 · maintenance only
62/100
- Activity 50
- Release rhythm 55
- Longevity 100
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: 22.5
- age_days: 2993
- days_rel: 301
- days_push: 301
- n_releases_24m: 9
Adoption not part of the score
1647 stars · 292 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
A dependency-free JavaScript library for converting and querying Solar (Gregorian), Chinese Lunar, Buddhist, and Taoist calendars. It provides rich traditional Chinese calendar data including ganzhi (heavenly stems and earthly branches), zodiac animals, solar terms, festivals, Ba Zi (eight characters), auspicious/inauspicious activities, deity directions, and official Chinese statutory holidays.
Use cases
- convert gregorian dates to chinese lunar calendar in javascript
- get chinese zodiac and ganzhi for a date
- compute ba zi (eight characters) from a birth date and time
- look up chinese statutory holidays and adjusted workdays
- find solar terms and traditional festivals for a year
- query auspicious days and daily yi/ji (宜忌) from the almanac
- build a lunar calendar widget for a web app
When to choose
- you need accurate solar-lunar conversion with traditional Chinese calendar details in JavaScript/Node.js
- you want zero third-party dependencies
- you need Ba Zi, zodiac, solar terms, or almanac features
- you need Chinese statutory holiday and调休 data
When to avoid
- you need true solar time calculations (not supported)
- you need a calendar for non-Chinese lunar systems like Islamic or Hebrew calendars
- you need i18n calendar formatting beyond what the library provides
- you work in a non-JavaScript stack (ports exist for other languages but this repo is JS)
Facets
library · maturity stable
date-time sdk developer-tools developer-tools cross-platform browser cross-platform chinese-lunar-calendar solar-calendar almanac ba-zi eight-characters traditional-chinese-calendar holidays solar-terms zodiac buddhist-calendar taoist-calendar zero-dependency localization nodejs javascript
5 sources
- readme: https://github.com/6tail/lunar-javascript · fetched 2026-08-28 · b1a8361192eb
- homepage: https://6tail.cn/calendar/api.html · fetched 2026-08-29 · ae776d3ffa1e
- site_page: https://6tail.cn/calendar/holiday-util.about.html · fetched 2026-08-29 · 0242ceae049c
- registry_npm: https://registry.npmjs.org/lunar-javascript · fetched 2026-08-29 · 654a23a6f907
- site_page: https://6tail.cn/calendar/faq.html · fetched 2026-08-29 · 90631a4731fc
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| 6tail/lunar-javascript | main | 62 |
For agents
markdown · JSON · MCP: product_card(name="6tail/lunar-javascript")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem