带农历的JavaScript日期时间

封面图 • 2025-12-01 • JavaScript

在 JavaScript 中，如果你想要处理 **农历（阴历）日期**，可以使用一些现成的库来实现。因为 JavaScript 本身不支持农历计算，所以需要借助第三方库。

---

## ✅ 推荐的农历库

### 1. [lunar-calendar](https://github.com/sunzhiwei/lunar-calendar)

这是一个轻量级的 JavaScript 库，用于将公历（阳历）转换为农历（阴历），并支持日期格式化。

#### 安装方式（npm）：

```bash
npm install lunar-calendar
```

#### 示例代码：

```javascript
const Lunar = require('lunar-calendar');

// 将公历日期转为农历
const lunar = Lunar.fromDate(new Date(2025, 4, 1)); // 2025年5月1日（注意：月份从0开始）

console.log("公历: " + new Date(2025, 4, 1));
console.log("农历: " + lunar.lunarYear + "年" + lunar.lunarMonth + "月" + lunar.lunarDay + "日");
console.log("干支: " + lunar.ganzhi);
console.log("生肖: " + lunar.shengxiao);
console.log("节气: " + lunar.solarTerms);
```

---

### 2. [chinese-lunar-calendar](https://www.npmjs.com/package/chinese-lunar-calendar)

另一个流行的农历库，功能也较全面。

#### 安装：

```bash
npm install chinese-lunar-calendar
```

#### 示例代码：

```javascript
const ChineseLunarCalendar = require('chinese-lunar-calendar');

const date = new Date(2025, 4, 1); // 2025年5月1日
const lunar = ChineseLunarCalendar.getLunar(date);

console.log("公历: " + date);
console.log("农历: " + lunar.year + "年" + lunar.month + "月" + lunar.day + "日");
console.log("干支: " + lunar.ganzhi);
console.log("节气: " + lunar.solarTerm);
```

---

## 🌟 如果你只是想显示带农历的日期字符串

你可以使用 `moment` + `moment-chinese-calendar` 或者 `date-fns` + 自定义农历函数。

---

## ✅ 总结

| 功能 | 推荐库 |
|------|--------|
| 公历转农历 | [lunar-calendar](https://github.com/sunzhiwei/lunar-calendar) |
| 更多农历信息 | [chinese-lunar-calendar](https://www.npmjs.com/package/chinese-lunar-calendar) |
| 日期格式化 | `moment`, `date-fns`（结合农历库使用） |

---

如果你有具体的需求（比如显示农历节日、节气、干支等），欢迎告诉我，我可以提供更详细的示例。