农历日历系列

一个功能丰富、界面精美的农历日历应用套件，提供多种日历视图和传统历法信息。

项目简介

农历日历系列是一个纯前端实现的日历应用，集成了中国传统的农历、节气、节日等信息。项目采用现代化的 UI 设计，支持响应式布局，可在各种设备上流畅使用。

功能特性

• 📅 万能日历 - 传统黄历日历，包含宜忌、节气、节日等信息
• 📆 万年历 - 完整的农历万年历，支持长时间范围查询
• 📊 年历视图 - 全年12个月历概览，清晰展示整年信息
• 🌙 农历月历 - 传统农历月历，突出显示农历日期和节日
• ☀️ 阳历月历 - 标准阳历月历，包含农历信息对照
• 📋 周日历 - 周视图展示，配有节气图标和详细信息

核心功能

• ✅ 完整的农历日期转换
• ✅ 二十四节气显示
• ✅ 传统节日和法定节假日标注
• ✅ 黄历宜忌信息
• ✅ 天干地支纪年法
• ✅ 农历年月日显示
• ✅ 可定制的主题颜色和背景
• ✅ 流畅的动画效果（基于 GSAP）
• ✅ 响应式设计，支持移动端
• ✅ 本地存储用户偏好设置

技术栈

• HTML5 - 页面结构
• CSS3 - 样式设计，使用渐变、动画、Flexbox/Grid 布局
• JavaScript (ES6+) - 业务逻辑实现
• GSAP - 动画库，提供流畅的过渡效果

项目结构

lunar-calendar/
├── index.html                  # 主入口，导航页面
├── Calendar.html               # 万能日历页面
├── PerpetualCalendar.html      # 万年历页面
├── LunarCalendar.html          # 农历月历页面
├── SolarMonthCalendar.html     # 阳历月历页面
├── WeekCalendar.html           # 周日历页面
├── YearCalendar.html           # 年历视图页面
├── lunar.js                    # 农历计算核心逻辑
├── gsap-3.12.2-gsap.min.js     # GSAP动画库
├── imgs/                       # 图片资源目录
├── README.md                   # 项目说明文档
└── LICENSE                     # MIT开源协议

快速开始

方法一：直接打开

1. 克隆或下载本项目到本地
2. 使用浏览器打开 index.html 文件
3. 开始使用各种日历功能

方法二：使用本地服务器

# 使用 Python 3
python -m http.server 8000

# 或使用 Node.js (需要先安装 http-server)
npx http-server -p 8000

然后在浏览器中访问 http://localhost:8000

方法三：使用 VS Code

1. 安装 Live Server 扩展
2. 右键点击 index.html
3. 选择 "Open with Live Server"

使用说明

导航栏

左侧导航栏列出了所有可用的日历类型，点击即可切换查看：

• 万能日历 - 传统的黄历日历，适合日常查询
• 万年历 - 支持长范围日期查询的完整历法
• 年历视图 - 一次性查看全年12个月的概览
• 农历月历 - 以农历为主视角的月历
• 阳历月历 - 以阳历为主视角的月历
• 周日历 - 以周为单位的详细视图

配置选项

点击右上角的⚙️配置按钮，可以：

• 🎨 背景颜色 - 自定义页面的背景渐变色
• 🌈 主题颜色 - 调整导航栏和高亮元素的颜色
• ⚡ 动画速度 - 控制页面过渡动画的快慢

配置会自动保存到浏览器本地存储，下次访问时自动应用。

浏览器兼容性

• Chrome/Edge 90+
• Firefox 88+
• Safari 14+
• Opera 76+

开发计划

• 添加更多传统节日信息
• 支持导出日历为图片/PDF
• 添加日程提醒功能
• 支持多语言（繁体中文、英文）
• 添加农历生日提醒
• 支持暗黑模式
• 添加更多自定义主题

贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

常见问题

Q: 为什么有些日期显示不准确？

A: 农历计算基于算法推算，可能与官方发布的农历存在细微差异。如需精确的官方历法，请参考国务院发布的法定节假日安排。

Q: 数据存储在哪里？

A: 所有的用户配置（主题、颜色等）都存储在浏览器的 localStorage 中，不会上传到服务器。

Q: 可以离线使用吗？

A: 可以。项目完全使用纯前端技术实现，不依赖任何后端服务，所有文件下载后即可离线使用。

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

作者与贡献

本项目的代码由 CodeBuddy 编写实现，geekswg 负责辅助设计和 Bug 修复。感谢所有贡献者的支持！

致谢

• GSAP - 强大的动画库
• 农历算法参考了多个开源实现

联系方式

如有问题或建议，欢迎提交 Issue。

---

⭐ 如果这个项目对您有帮助，请给一个 Star 支持一下！