Python chinese-calendar 库使用指南

chinese-calendar 库作为专业的 Python 节假日解决方案，为开发者提供了从 2004 年到 2026 年的完整中国节假日数据支持，让节假日计算变得简单高效。

安装与配置

使用 pip 命令快速安装 chinesecalendar 库：

pip install chinesecalendar

或者从源码安装最新版本：

git clone https://github.com/jaywcjlove/chinese-calendar
cd chinese-calendar
pip install .

基础功能体验

导入库并开始使用：

import datetime
from chinese_calendar import is_holiday, is_workday

# 判断特定日期状态
test_date = datetime.date(2024, 10, 1)
print(f"2024 年国庆节是节假日：{is_holiday(test_date)}")
print(f"2024 年国庆节是工作日：{is_workday(test_date)}")

功能特性

计算维度	传统方案	chinese-calendar 方案
数据准确性	依赖人工更新	基于官方通知
开发效率	需要大量编码	一行代码即可判断
维护成本	持续人工维护	自动更新零维护
覆盖范围	有限年份数据	2004-2026 完整数据

核心功能

• 节假日识别：准确判断法定节假日
• 工作日计算：智能识别调休安排
• 状态查询：获取日期详细状态信息
• 节假日列表：获取指定时间段所有节假日
• 调休日检测：识别补班调休情况
• 工作日统计：计算时间段内工作日数量

应用场景

企业考勤系统集成

在考勤系统中集成节假日判断：

from chinese_calendar import is_workday
import datetime

 :
     ():
        
         is_workday(check_date)

     ():
        
        workday_count = 
        current_date = start_date
         current_date <= end_date:
             is_workday(current_date):
                workday_count += 
            current_date += datetime.timedelta(days=)
         workday_count