最近处理工作任务的时候遇到了转换农历的问题。一开始我打算搜索在线处理的网站或者转换的接口，结果找到了一个Python库可以直接解决，今天正好同大家分享一下。
农历，是我国现行的传统历法。它是根据月相的变化周期，每一次月相朔望变化为一个月，参考太阳回归年为一年的长度，并加入二十四节气与设置闰月以使平均历年与回归年相适应[1]。
对于我们处理数据来说，并不需要去详细研究农历与公历之间的转换关系。在Python中，ZhDate库支持农历-公历互相转换、日期加减以及全中文日期生成，内置了1900-2100年的农历数据，仅依赖Python内置模块。github.com/CutePandaSh/zhdate
由于ZhDate属于Python的第三⽅开源模块，因此需要额外安装、导⼊后，才能使⽤。直接在命令⾏窗⼝中输⼊如下命令：
pip install zhdate详细使用方法
zhdate库，不用网络接口直接本地计算中国农历，支持农历阳历互转[2]。
阳历与农历日期的相互转换
在交互式环境中输入如下命令：
from zhdate import ZhDate
date1 = ZhDate(2022, 2, 2) # 新建农历 2022年二月初二（龙抬头）的日期对象
print(date1) # 直接返回农历日期字符串d输出：
农历2022年2月2日在交互式环境中输入如下命令：
t_date1 = date1.to_datetime()
t_date1输出：
datetime.datetime(2022, 3, 4, 0, 0)在交互式环境中输入如下命令：
from datetime import datetime
dt_date2 = datetime(2022, 2, 6)
date2 = ZhDate.from_datetime(dt_date2) # 从阳历日期转换成农历日期对象
date2输出：
农历2022年1月6日闰月
在交互式环境中输入如下命令：
date3 = ZhDate(2020, 4, 15) # 新建农历 2020年4月15日
print(date3.to_datetime())输出：
2020-05-07 00:00:00
在交互式环境中输入如下命令：
date3 = ZhDate(2020, 4, 15) # 新建农历 2020年闰4月15日
print(date3.to_datetime())输出：
2020-06-06 00:00:00这一年农历4月15日的同学，可以分别在5月7日和6月6日分别过两次农历生日。
其他
中文输出，在交互式环境中输入如下命令：
dt_date4 = datetime(2022, 3, 4)
date4 = ZhDate.from_datetime(dt_date4)
print(date4.chinese())输出：
二零二二年二月初二 壬寅年 (虎年)当天的农历日期，在交互式环境中输入如下命令：
ZhDate.today()输出：
农历2022年2月7日此外，zhdate模块也支持加减法。两个zhdate对象相减可以得到两个农历日期的差额，同时加整数也可以返回相隔天数以后的新农历对象。
实战：计算节日距离天数
下面通过一个实战项目练习一下这个zhdate模块。
加入我们想快速地了解今天距离某个节日还有多少天？可以使用zhdate和datetime库搭配解决这个问题。
在交互式环境中输入如下命令：
today = datetime.now()
data_str = today.strftime('%Y-%m-%d')
data_str输出：
'2022-03-09'计算距离劳动节的天数，在交互式环境中输入如下命令：
oneDay = datetime(2022, 5, 1)
difference = oneDay.toordinal()-today.toordinal()
print(f'今天 {data_str} 距离五一劳动节还有 {difference} 天')输出：
今天 2022-03-09 距离五一劳动节还有 53 天
计算距离中秋节的天数，在交互式环境中输入如下命令：
oneDay = ZhDate(2022, 8, 15).to_datetime()
difference = oneDay.toordinal()-today.toordinal()
print(f'今天 {data_str} 距离中秋节还有 {difference} 天')输出：
今天 2022-03-09 距离中秋节还有 185 天大家有时间也可以动手试一试，测试一下还距离其他节日多少天？实战时要注意该节日是按照公历统计还是农历设置的。
参考资料
[1]
百度百科-农历: https://baike.baidu.com/item/%E5%86%9C%E5%8E%86/67925
[2]github: https://github.com/CutePandaSh/zhdate
这是我开发的机器人公众号小号，目前增加了天气查询，955公司名单，关注时间查询；后面还会增加图片功能和每日送书抽奖送书活动，以及调戏功能，欢迎来体验，捧场。
一个机器人公众号已经上线，欢迎调戏
推荐阅读:
入门: 最全的零基础学Python的问题 | 零基础学了8个月的Python | 实战项目 |学Python就是这条捷径
干货:爬取豆瓣短评，电影《后来的我们》 | 38年NBA最佳球员分析 | 从万众期待到口碑扑街！唐探3令人失望 | 笑看新倚天屠龙记 | 灯谜答题王 ｜用Python做个海量小姐姐素描图 ｜碟中谍这么火，我用机器学习做个迷你推荐系统电影
趣味:弹球游戏 | 九宫格 | 漂亮的花 | 两百行Python《天天酷跑》游戏!
AI: 会做诗的机器人 | 给图片上色 | 预测收入 | 碟中谍这么火，我用机器学习做个迷你推荐系统电影
小工具: Pdf转Word，轻松搞定表格和水印！ | 一键把html网页保存为pdf！| 再见PDF提取收费！ | 用90行代码打造最强PDF转换器，word、PPT、excel、markdown、html一键转换 | 制作一款钉钉低价机票提示器！ ｜60行代码做了一个语音壁纸切换器天天看小姐姐！｜年度爆款文案
点阅读原文，看B站我的视频！
扫一扫
1076
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
