Calendar.js：终极JavaScript日历解决方案 - 简单实现农历公历互转
项目地址: https://gitcode.com/gh_mirrors/ca/calendar.js Calendar.js 是一款功能强大的 JavaScript 库，专注于实现中国农历（阴阳历）和公历之间的精准互转。无论是开发传统节日应用、出生日期查询工具，还是需要处理农历日期的网页项目，这款轻量级工具都能提供简单高效的解决方案。
📦 快速安装指南
通过 npm 一键安装
npm i js-calendar-converter
直接引入使用
下载项目后，通过 demo.html 可查看简单示例调用。核心功能文件位于 src/index.js，包含所有日历转换逻辑。
🌟 核心功能与使用示例
1. 公历转农历
通过 solar2lunar 方法可将公历日期转换为农历数据，返回包含天干地支、生肖、节气等信息的 JSON 对象：
// 公历1987年11月1日转农历
calendar.solar2lunar(1987, 11, 01);
返回结果示例：
{
"Animal": "兔",
"IDayCn": "初十",
"IMonthCn": "九月",
"gzYear": "丁卯",
"lYear": 1987,
"lMonth": 9,
"lDay": 10
}
2. 农历转公历
使用 lunar2solar 方法可将农历日期（支持闰月）转换为公历日期：
// 农历1987年9月10日转公历
calendar.lunar2solar(1987, 9, 10);
🧩 项目结构解析
核心代码组织在 src 目录下，按功能模块划分：
- 常量定义：src/constant/ 包含农历节气、生肖、天干地支等基础数据
- ChineseZodiac.js：生肖与年份映射
- SolarTerm.js：二十四节气数据
- 主逻辑：src/index.js 提供对外 API 接口
🚀 开发与构建
项目使用 Rollup 构建工具，执行以下命令生成生产版本：
npm run build
构建结果输出至 dist 目录，包含 CommonJS 和 ES Module 两种格式。
📝 许可证信息
本项目采用 GPL-3.0-or-later 许可证，详细条款参见 LICENSE 文件。
无论是开发传统节日应用、出生日期查询工具，还是需要处理农历日期的网页项目，Calendar.js 都能提供可靠、高效的日期转换能力，让你轻松应对各类日历需求。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
