# lunar-javascript

> lunar是一款无第三方依赖的公历(阳历)、农历(阴历、老黄历)、佛历和道历工具，支持星座、儒略日、干支、生肖、节气、节日、彭祖百忌、每日宜忌、吉神宜趋、凶煞宜忌、吉神(喜神/福神/财神/阳贵神/阴贵神)方位、胎神方位、冲煞、纳音、星宿、八字、五行、十神、建除十二值星、青龙名堂等十二神、黄道日及吉凶等。lunar is a calendar library for Solar and Chinese Lunar.

Latest version **1.7.8** (published 2026-11-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install lunar-javascript
pnpm add lunar-javascript
yarn add lunar-javascript
bun add lunar-javascript
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.7.8 |
| Published | 2026-11-06 |
| First published | 2020-05-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 500.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1735 |
| Author | 6tail |
| Maintainers | 6tail |
| Keywords | calendar, lunar, solar, 节假日, 星座, 儒略日, 干支, 生肖, 节气, 节日, 彭祖百忌, 每日宜忌, 时辰宜忌, 吉神宜趋, 凶煞宜忌, 喜神, 福神, 财神, 阳贵神, 阴贵神, 胎神, 冲煞, 纳音, 星宿, 八字, 五行, 十神, 建除十二值星, 青龙名堂等十二神, 黄道黑道日 |

## Links

- npm: https://www.npmjs.com/package/lunar-javascript
- Repository: https://github.com/6tail/lunar-javascript
- Issues: https://github.com/6tail/lunar-javascript/issues
- npm.io page: https://npm.io/package/lunar-javascript

## Recent versions

- 1.7.8 (latest) — 2026-11-06
- 1.7.7 — 2025-11-05
- 1.7.6 — 2025-10-21
- 1.7.5 — 2025-10-01
- 1.7.4 — 2025-09-07
- 1.7.3 — 2025-04-29
- 1.7.2 — 2025-04-07
- 1.7.1 — 2025-03-05
- 1.7.0 — 2025-02-12
- 1.6.13 — 2024-11-12
- 1.6.12 — 2024-03-17
- 1.6.11 — 2024-02-29
- 1.6.10 — 2024-02-06
- 1.6.9 — 2024-01-30
- 1.6.8 — 2024-01-03
- … 88 more at https://npm.io/package/lunar-javascript/versions

## README

# lunar [![License](https://img.shields.io/badge/license-MIT-4EB1BA.svg?style=flat-square)](https://github.com/6tail/lunar-javascript/blob/master/LICENSE)

lunar是一款无第三方依赖的公历(阳历)、农历(阴历、老黄历)、佛历和道历工具，支持星座、儒略日、干支、生肖、节气、节日、彭祖百忌、每日宜忌、吉神宜趋、凶煞宜忌、吉神(喜神/福神/财神/阳贵神/阴贵神)方位、胎神方位、冲煞、纳音、星宿、八字、五行、十神、建除十二值星、青龙名堂等十二神、黄道日及吉凶等。

[English](https://github.com/6tail/lunar-javascript/blob/master/README_EN.md)

## 示例

### 普通页面

```html
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
  </head>
  <body>
    <script src="lunar.js"></script>
    <script>
      var solar = Solar.fromYmd(1986,5,29);
      console.log(solar.toFullString());
      console.log(solar.getLunar().toFullString());
    </script>
  </body>
</html>
```

### npm

    npm init
    npm install lunar-javascript
     
    //test.js
    const {Solar} = require('lunar-javascript')
    //const {Solar, Lunar, HolidayUtil} = require('lunar-javascript')
     
    let solar = Solar.fromYmd(1986,5,29);
    console.log(solar.toFullString());
    console.log(solar.getLunar().toFullString());
     
    node test.js

### Node.js

    //test.js
    const {Solar} = require('./lunar.js')
    //const {Solar, Lunar, HolidayUtil} = require('./lunar.js')
     
    let solar = Solar.fromYmd(1986,5,29);
    console.log(solar.toFullString());
    console.log(solar.getLunar().toFullString());
     
    node test.js

输出结果：

    1986-05-29 00:00:00 星期四 双子座
    一九八六年四月廿一 丙寅(虎)年 癸巳(蛇)月 癸酉(鸡)日 子(鼠)时 纳音[炉中火 长流水 剑锋金 桑柘木] 星期四 北方玄武 星宿[斗木獬](吉) 彭祖百忌[癸不词讼理弱敌强 酉不会客醉坐颠狂] 喜神方位[巽](东南) 阳贵神方位[巽](东南) 阴贵神方位[震](正东) 福神方位[兑](正西) 财神方位[离](正南) 冲[(丁卯)兔] 煞[东]

## 文档

请移步至 [https://6tail.cn/calendar/api.html](https://6tail.cn/calendar/api.html "https://6tail.cn/calendar/api.html")

---
_Source: https://npm.io/package/lunar-javascript · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._