ChineseCalendar
是一个 Python 包,用于获取中国传统日历信息。这个包提供了中国农历、二十四节气、传统节日、黄历等信息。你可以使用以下命令来安装这个包:
pip install ChineseCalendar
安装完成后,你可以在你的 Python 代码中导入该包并使用其中的函数来获取相关的中国传统日历信息。以下是一个例子:
from ChineseCalendar import ChineseCalendar# 获取当前日期的农历信息
today = ChineseCalendar().solar_to_lunar(2023, 3, 28)
print(today)# 获取当前日期的二十四节气
term = ChineseCalendar().get_solar_term(2023, 3, 28)
print(term)# 获取当前日期的传统节日
holiday = ChineseCalendar().get_holiday(2023, 3, 28)
print(holiday)# 获取当前日期的黄历
almanac = ChineseCalendar().get_almanac(2023, 3, 28)
print(almanac)
在这个例子中,我们使用 ChineseCalendar() 类来创建一个日历对象。然后,我们使用 solar_to_lunar()
函数获取当前日期的农历信息;使用 get_solar_term()
函数获取当前日期的二十四节气;使用 get_holiday()
函数获取当前日期的传统节日;使用 get_almanac()
函数获取当前日期的黄历。
该包提供了以下几个类:
- LunarDate:用于表示农历日期的类,包含年、月、日、是否闰月等属性,可以进行与公历日期的转换。
- Holiday:用于表示节假日的类,包含节假日名称、日期、类型等属性,可以根据公历日期获取该日期是否为节假日。
- ChineseCalendar:是主要的类,用于提供中国农历和节假日的计算功能。它包含了以下方法:
- get_lunar_date:根据公历日期获取对应的农历日期。
- get_solar_date:根据农历日期获取对应的公历日期。
- get_holiday_detail:获取指定日期的节假日详情,包括节假日名称、类型、假期长度等。
- is_holiday:判断指定日期是否为节假日。
- get_workday_delta:计算指定日期后若干个工作日的日期,可用于计算调休后的工作日。
以上就是 ChineseCalendar 包中的主要类和方法。使用这些类和方法,可以方便地进行中国农历和节假日的计算和查询。