Python 库 chinese-calendar 的使用方法。该库提供 2004 至 2026 年中国法定节假日及调休数据，支持判断工作日、节假日及调休日。通过 pip 安装后，可使用 is_holiday、is_workday、get_holiday_detail 等函数进行日期判断。适用于考勤系统、财务计算及项目排期等场景。需注意每年更新版本以同步官方节假日安排，并处理超出支持年份的异常。
在开发涉及中国法定节假日计算的应用程序时，你是否经常遇到这样的困扰：如何准确判断某一天是不是工作日？如何智能识别调休安排？如何获取完整的节假日列表？chinese-calendar 这个专业的 Python 库正是为解决这些问题而生，它为开发者提供了从 2004 年到 2026 年的完整中国节假日数据支持。
企业级应用痛点解决方案
技术优势对比
| 特性 | chinese-calendar | 手动维护方案 |
|---|---|---|
| 数据准确性 | 基于官方通知 | 依赖人工更新 |
| 开发效率 | 一行代码即可判断 | 需要大量编码 |
| 维护成本 | 自动更新，零维护 | 持续人工维护 |
| 覆盖范围 | 2004-2026 年完整数据 | 有限年份数据 |
# 使用 pip 安装最新版本
pip install chinesecalendar
import datetime
from chinese_calendar import is_holiday, is_workday
# 判断 2024 年国庆节是否为节假日
national_day = datetime.date(2024, 10, 1)
print(f"2024 年 10 月 1 日是节假日：{is_holiday(national_day)}")
print(f"2024 年 10 月 1 日是工作日：{is_workday(national_day)}")
chinese-calendar 库的核心功能是准确判断任意日期的工作日状态。其判断逻辑基于官方发布的节假日安排，确保与实际情况完全一致。
# 获取节假日详细信息
import chinese_calendar as calendar
import datetime
date_to_check = datetime.date(2024, 1, 1)
is_holiday_flag, holiday_name = calendar.get_holiday_detail(date_to_check)
if is_holiday_flag:
print(f"{date_to_check} 是 {holiday_name}")
else:
print(f"{date_to_check} 是工作日")
中国节假日安排中经常出现的调休情况，该库也能准确识别：
from chinese_calendar import is_in_lieu
# 判断是否为调休日
is_compensated_rest = is_in_lieu(datetime.date(2024, 2, 4))
print(f"是否为调休日：{is_compensated_rest}")
from chinese_calendar import get_workdays, is_workday
import datetime
class AttendanceSystem:
def __init__(self):
self.workday_cache = {}
def calculate_workdays(self, start_date, end_date):
"""计算指定时间段内的工作日数量"""
workdays_list = get_workdays(start_date, end_date, include_weekends=False)
return len(workdays_list)
def is_valid_work_date(self, check_date):
"""验证日期是否为有效工作日"""
return is_workday(check_date)
# 使用示例
attendance = AttendanceSystem()
workday_count = attendance.calculate_workdays(
datetime.date(2024, 1, 1),
datetime.date(2024, 12, 31)
)
print(f"2024 年工作日总数：{workday_count}")
from chinese_calendar import find_workday
import datetime
def calculate_interest(principal, rate, start_date, days):
"""按工作日计算利息"""
current_date = start_date
workday_count = 0
for i in range(days):
if is_workday(current_date):
workday_count += 1
current_date += datetime.timedelta(days=1)
interest = principal * rate * workday_count / 365
return interest
# 计算下一个工作日
next_business_day = find_workday(delta_days=1)
print(f"下一个工作日是：{next_business_day}")
from chinese_calendar import get_holidays
import datetime
def analyze_holiday_pattern(year):
"""分析指定年份的节假日分布"""
start_date = datetime.date(year, 1, 1)
end_date = datetime.date(year, 12, 31)
# 获取所有节假日（包含周末）
all_holidays = get_holidays(start_date, end_date, include_weekends=True)
# 获取法定节假日（不包含周末）
legal_holidays = get_holidays(start_date, end_date, include_weekends=False)
return {
'total_holidays': len(all_holidays),
'legal_holidays': len(legal_holidays),
'holiday_distribution': [h.strftime('%Y-%m-%d') for h in legal_holidays]
}
# 分析 2024 年节假日
holiday_analysis = analyze_holiday_pattern(2024)
print(holiday_analysis)
除了法定节假日，chinese-calendar 还提供了 24 节气的计算功能：
from chinese_calendar import get_solar_terms
# 获取 2024 年所有节气
solar_terms_2024 = get_solar_terms(
datetime.date(2024, 1, 1),
datetime.date(2024, 12, 31)
)
chinese-calendar 库支持的中国法定节假日包括：
# 每年年底更新以获取最新节假日数据
pip install -U chinesecalendar
Q: 为什么需要每年更新库版本？ A: 因为中国的节假日安排每年由官方发布，存在变动可能，更新版本确保数据准确性。
Q: 如何处理超出支持年份的日期？ A: 库会自动抛出 NotImplementedError 异常，建议在代码中进行范围检查。
Q: 是否支持其他国家或地区的节假日？ A: 当前版本专注于中国法定节假日，不支持其他地区。
Q: 如何获取特定年份的所有节假日列表？
A: 使用 get_holidays() 函数，指定起始和结束日期。
chinese-calendar 库作为中国节假日计算的标准解决方案，将继续：
通过使用 chinese-calendar 库，开发者可以轻松解决中国节假日计算的复杂问题，显著提升开发效率和系统准确性。无论是企业级应用还是个人项目，这个库都能提供可靠的技术支持。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online