如何用Lunar JavaScript轻松搞定农历公历转换？完整实用指南 🚀

Lunar JavaScript是一款功能强大的开源日期处理工具，专为JavaScript开发者设计，可实现公历与农历的精准转换，还提供节气计算、节假日查询等丰富功能。无论是开发传统节日应用还是进行复杂的日期运算，它都能成为你的得力助手。

🌟 为什么选择Lunar JavaScript？

作为一款专注于农历转换的轻量级库，Lunar JavaScript凭借以下优势脱颖而出：

• ✅ 高精度算法：采用权威农历转换算法，确保节气、闰月等数据准确无误
• ⚡ 极速性能：毫秒级响应速度，适合大规模日期处理场景
• 🌍 多语言支持：内置国际化模块，轻松实现多语言日期展示
• 📦 零依赖：纯JavaScript编写，无需额外安装其他库

🚀 3步快速上手Lunar JavaScript

1️⃣ 一键安装步骤

git clone https://gitcode.com/gh_mirrors/lu/lunar-javascript
cd lunar-javascript
npm install

2️⃣ 基础使用示例

const lunar = require('./lunar');

// 公历转农历
const solarDate = new Date(2023, 6, 7);
const lunarDate = lunar.fromSolar(solarDate);
console.log(`农历日期：${lunarDate.getLunarYear()}年${lunarDate.getLunarMonth()}月${lunarDate.getLunarDay()}日`);

// 农历转公历
const lunarObj = {year: 2023, month: 5, day: 20, isLeap: false};
const convertedSolar = lunar.toSolar(lunarObj);
console.log(`转换后的公历日期：${convertedSolar.toLocaleDateString()}`);

3️⃣ 节气与节假日查询

// 获取指定日期的节气
const jieqi = lunar.getJieQi(new Date(2023, 1, 4));
console.log(`当前节气：${jieqi}`);

// 检查是否为节假日
const holiday = lunar.isHoliday(new Date(2023, 0, 1));
console.log(`是否为节假日：${holiday ? '是' : '否'}`);

💡 实用功能全解析

📅 日期格式化技巧

Lunar JavaScript提供灵活的日期格式化功能，满足不同场景需求：

// 自定义日期格式
const formatted = lunar.format(new Date(), 'yyyy年MM月dd日 HH:mm:ss 星期W');
console.log(formatted); // 输出示例：2023年07月07日 15:30:22 星期五

支持的格式化字符包括：

• yyyy：四位年份
• MM：两位月份
• dd：两位日期
• HH：24小时制小时
• mm：分钟
• ss：秒
• W：星期（中文）

🔍 八字命理计算

对于需要传统命理功能的应用，Lunar JavaScript提供八字排盘功能：

const eightChar = lunar.getEightChar(new Date(1990, 0, 1, 8, 30));
console.log(`生辰八字：${eightChar}`);

📊 节气时间查询

精确获取二十四节气的具体时间：

const jieqiTime = lunar.getJieQiTime(2023, '立春');
console.log(`立春时间：${jieqiTime.toLocaleString()}`);

🛠️ 项目结构与核心模块

Lunar JavaScript采用模块化设计，核心功能集中在以下文件：

• lunar.js：主模块，包含所有核心转换功能
• index.js：对外API接口，简化调用方式
• tests/：完整测试套件，确保功能稳定性

📝 使用场景与实战案例

传统节日应用开发

轻松实现春节、中秋节等传统节日的日期计算：

// 获取春节日期
const springFestival = lunar.getChineseNewYear(2024);
console.log(`2024年春节：${springFestival.toLocaleDateString()}`);

日历组件集成

与前端框架结合，开发功能丰富的日历组件：

// 生成某月农历数据
const monthData = lunar.getMonthData(2023, 10);
console.log(monthData); // 返回包含每日农历信息的数组

历史日期查询工具

开发历史事件查询应用时，快速转换历史日期：

// 转换历史日期
const historicalDate = new Date(1949, 9, 1);
const lunarHistorical = lunar.fromSolar(historicalDate);
console.log(`建国日农历：${lunarHistorical.toString()}`);

📚 进阶学习资源

单元测试示例

项目提供完整的测试用例，可作为学习参考：

• 节气测试：tests/JieQi.test.js
• 农历转换测试：tests/Lunar.test.js
• 节假日测试：tests/Holiday.test.js

常用API速查表

功能	方法
公历转农历	lunar.fromSolar(date)
农历转公历	lunar.toSolar(lunarObj)
获取节气	lunar.getJieQi(date)
日期格式化	lunar.format(date, pattern)
八字排盘	lunar.getEightChar(date)

🚀 开始使用Lunar JavaScript

只需简单几步，即可将Lunar JavaScript集成到你的项目中：

1. 克隆仓库：

git clone https://gitcode.com/gh_mirrors/lu/lunar-javascript

2. 引入模块：

const lunar = require('./lunar');

3. 开始使用：

console.log(lunar.fromSolar(new Date()).toString());

无论你是开发传统节日应用，还是构建复杂的日期处理系统，Lunar JavaScript都能为你提供可靠、高效的日期处理能力。立即尝试，体验农历公历转换的便捷与高效！