Lunar Python 快速上手教程:农历日期转换
为什么选择 Lunar Python?
零依赖的轻量级解决方案 Lunar Python 最大的优势在于完全基于 Python 标准库开发,无需安装任何第三方依赖。这意味着你可以在任何 Python 环境中安心使用,不用担心版本冲突或依赖问题。
多历法系统的完美集成 一个工具就能同时处理公历、农历、佛历和道历四种历法系统。这在实际开发中意味着你可以:
- 轻松构建支持多历法的日历应用
- 准确计算中国传统节日和节气
- 为文化类应用提供完整的日期支持
核心功能快速体验
基础日期转换 从最简单的需求开始——公历和农历之间的相互转换。这是最常用也是最基础的功能:
from lunar_python import Lunar, Solar
# 农历转公历示例
lunar_date = Lunar.fromYmd(2023, 1, 1)
solar_date = lunar_date.getSolar()
print(f"农历正月初一对应的公历是:{solar_date.toFullString()}")
# 公历转农历示例
solar_date = Solar.fromYmd(2023, 1, 22)
lunar_date = solar_date.getLunar()
print(f"公历 1 月 22 日对应的农历是:{lunar_date.toString()}")
节气查询与节日识别 二十四节气和传统节日是中国文化的重要组成部分。Lunar Python 内置了完整的节气计算和节日识别功能:
# 节气查询
solar_date = Solar.fromYmd(2023, 12, 22) # 冬至
lunar_date = solar_date.getLunar()
jieqi = lunar_date.getJieQi()
print(f"这一天是:{jieqi}")
# 节日识别
lunar_date = Lunar.fromYmd(2023, 8, 15) # 中秋节
festivals = lunar_date.getFestivals()
for festival in festivals:
print(f"传统节日:")

