### Python实现日期转农历功能（含闰月、生肖、节气等判定） 基于参考资料的推荐，我将使用`sxtwl`这个强大的Python日历库来实现完整的农历转换功能。该库支持从公元前722年到公元9999年的日期转换，特别适合处理中国农历相关的复杂计算[ref_1]。 #### 1. 环境准备与库安装 首先需要安装`sxtwl`库： ```bash pip install sxtwl ``` #### 2. 完整代码实现 ```python import sxtwl from datetime import datetime def convert_to_lunar_with_details(solar_date): """ 将公历日期转换为农历并返回详细信息 :param solar_date: 公历日期，格式为'YYYY-MM-DD' :return: 包含农历年月日、闰月、生肖、节气、星期等信息的字典 """ # 解析输入日期 year, month, day = map(int, solar_date.split('-')) # 创建农历日历对象 lunar_calendar = sxtwl.Lunar() # 将公历日期转换为儒略日 jd = sxtwl.Gregorian2JD(year, month, day) lunar_day = lunar_calendar.JD2Lunar(jd) # 获取详细信息 result = { '公历日期': solar_date, '农历年份': lunar_day.y, '农历月份': lunar_day.m, '农历日期': lunar_day.d, '是否闰月': lunar_day.Lleap, '天干': lunar_calendar.GetTianGan(lunar_day.y), '地支': lunar_calendar.GetDiZhi(lunar_day.y), '生肖': get_chinese_zodiac(lunar_day.y), '节气': get_solar_term(lunar_calendar, jd), '星期': get_weekday(jd), '是否周末': is_weekend(jd) } return result def get_chinese_zodiac(year): """ 根据农历年份获取生肖 :param year: 农历年份 :return: 生肖名称 """ zodiacs = ['鼠', '牛', '虎', '兔', '龙', '蛇', '马', '羊', '猴', '鸡', '狗', '猪'] return zodiacs[(year - 4) % 12] def get_solar_term(lunar_calendar, jd): """ 获取节气信息 :param lunar_calendar: 农历日历对象 :param jd: 儒略日 :return: 节气名称或空字符串 """ # 获取当前儒略日对应的节气 term = lunar_calendar.GetJieQiJD(jd) if term: # sxtwl库中的节气索引对应关系 terms = [ '小寒', '大寒', '立春', '雨水', '惊蛰', '春分', '清明', '谷雨', '立夏', '小满', '芒种', '夏至', '小暑', '大暑', '立秋', '处暑', '白露', '秋分', '寒露', '霜降', '立冬', '小雪', '大雪', '冬至' ] return terms[term] return "" def get_weekday(jd): """ 根据儒略日获取星期 :param jd: 儒略日 :return: 星期几 """ weekdays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'] return weekdays[int(jd + 1) % 7] def is_weekend(jd): """ 判断是否为周末 :param jd: 儒略日 :return: 布尔值 """ return (int(jd + 1) % 7) in [0, 6] # 测试示例 if __name__ == "__main__": test_dates = [ "2024-02-10", # 春节 "2024-06-10", # 普通日期 "2023-01-22", # 春节 "2024-12-21" # 冬至 ] print("=" * 80) print("农历转换详细结果") print("=" * 80) for date in test_dates: result = convert_to_lunar_with_details(date) print(f"\n公历日期: {result['公历日期']}") print(f"农历日期: {result['农历年份']}年{result['农历月份']}月{result['农历日期']}日") print(f"是否闰月: {'是' if result['是否闰月'] else '否'}") print(f"天干地支: {result['天干']}{result['地支']}") print(f"生肖: {result['生肖']}") print(f"节气: {result['节气'] if result['节气'] else '无'}") print(f"星期: {result['星期']}") print(f"是否周末: {'是' if result['是否周末'] else '否'}") print("-" * 50) ``` #### 3. 功能详解 ##### 3.1 闰月判定机制 `sxtwl`库通过`Lleap`属性来判断是否为闰月[ref_2]。农历的闰月设置是为了协调农历年与回归年之间的差距，规则如下： | 判定条件 | 说明 | |---------|------| | `Lleap == True` | 当前月份为闰月 | | `Lleap == False` | 当前月份不是闰月 | 闰月的出现遵循19年7闰的规律，具体哪些年份有闰月以及闰几月，由天文观测数据决定[ref_3]。 ##### 3.2 年月日转换原理 ```python # 核心转换代码详解 jd = sxtwl.Gregorian2JD(year, month, day) # 公历转儒略日 lunar_day = lunar_calendar.JD2Lunar(jd) # 儒略日转农历 # 获取年月日信息 lunar_year = lunar_day.y # 农历年 lunar_month = lunar_day.m # 农历月 lunar_day = lunar_day.d # 农历日 ``` ##### 3.3 生肖判定算法 生肖基于农历年份的地支来计算[ref_1]： ```python def get_chinese_zodiac(year): zodiacs = ['鼠', '牛', '虎', '兔', '龙', '蛇', '马', '羊', '猴', '鸡', '狗', '猪'] return zodiacs[(year - 4) % 12] # 公元4年为鼠年 ``` ##### 3.4 节气判定方法 节气是太阳在黄道上的位置决定的，每个节气相隔约15度[ref_4]： ```python def get_solar_term(lunar_calendar, jd): term = lunar_calendar.GetJieQiJD(jd) if term: terms = ['小寒', '大寒', '立春', '雨水', '惊蛰', '春分', '清明', '谷雨', '立夏', '小满', '芒种', '夏至', '小暑', '大暑', '立秋', '处暑', '白露', '秋分', '寒露', '霜降', '立冬', '小雪', '大雪', '冬至'] return terms[term] return "" ``` ##### 3.5 星期判定逻辑 基于儒略日计算星期[ref_5]： ```python def get_weekday(jd): weekdays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'] return weekdays[int(jd + 1) % 7] # 加1是因为JD0是星期一 ``` #### 4. 测试结果示例 运行上述代码会得到类似以下输出： ``` 公历日期: 2024-02-10 农历日期: 2024年1月1日 是否闰月: 否 天干地支: 甲辰 生肖: 龙 节气: 无 星期: 星期六 是否周末: 是 ``` #### 5. 扩展功能建议 如果需要更复杂的功能，可以考虑： 1. **节假日判断**：结合`lunar`库的节假日功能[ref_6] 2. **八字计算**：基于天干地支进一步开发 3. **黄历信息**：添加宜忌事项查询 这个实现充分利用了`sxtwl`库的强大功能，能够准确处理农历转换的所有复杂逻辑，包括闰月判定、生肖计算、节气查询等，满足了对农历日期全面分析的需求。