当前位置：首页 > news >正文

中国节假日智能判断终极指南：chinese-calendar库完全解析

news 2026/7/4 8:41:22

在开发涉及日期计算的应用程序时，准确判断中国法定节假日和工作日是一个常见但复杂的需求。chinese-calendar 是一个专业的 Python 库，专门解决这个问题。它支持从 2004 年至 2026 年的完整节假日数据，包括 2020 年春节延长假期等特殊情况的精准识别。

【免费下载链接】chinese-calendar判断一天是不是法定节假日/法定工作日（查看节假日安排）项目地址: https://gitcode.com/gh_mirrors/ch/chinese-calendar

🚀 快速开始：一键安装配置

基础安装步骤

使用 pip 命令即可快速安装最新版本：

pip install chinesecalendar

年度数据更新最佳实践

由于节假日安排依赖相关部门发布的最新通知，建议每年 11 月前后执行版本升级：

pip install -U chinesecalendar

💡 核心功能详解

基础日期类型判断

import datetime from chinese_calendar import is_holiday, is_workday # 判断 2018年4月30号 是不是节假日 april_last = datetime.date(2018, 4, 30) print(f"是否是节假日: {is_holiday(april_last)}") print(f"是否是工作日: {is_workday(april_last)}")

节假日详细信息获取

import chinese_calendar as calendar # 在判断的同时获取节日名称 on_holiday, holiday_name = calendar.get_holiday_detail(april_last) print(f"是否在节假日: {on_holiday}") print(f"节日名称: {holiday_name}")

调休日智能识别

import chinese_calendar # 判断法定节假日是否为调休 date1 = datetime.date(2006, 2, 1) date2 = datetime.date(2006, 2, 2) print(f"{date1} 是否为调休: {chinese_calendar.is_in_lieu(date1)}") print(f"{date2} 是否为调休: {chinese_calendar.is_in_lieu(date2)}")

📊 完整节假日类型覆盖

chinese-calendar 库支持的主要节假日类型包括：

元旦(New Year's Day) - 1天假期
春节(Spring Festival) - 3天法定节假日
清明节(Tomb-sweeping Day) - 1天假期
劳动节(Labour Day) - 1天假期
端午节(Dragon Boat Festival) - 1天假期
国庆节(National Day) - 3天法定节假日
中秋节(Mid-autumn Festival) - 1天假期

🎯 高级功能实战应用

时间段节假日统计

from chinese_calendar import get_holidays, get_workdays start_date = datetime.date(2024, 1, 1) end_date = datetime.date(2024, 12, 31) # 获取2024年所有节假日（包含周末） all_holidays = get_holidays(start_date, end_date, include_weekends=True) # 获取2024年所有工作日（不包含周末） workdays_only = get_workdays(start_date, end_date, include_weekends=False)

工作日智能查找

from chinese_calendar import find_workday # 查找下一个工作日 next_workday = find_workday(delta_days=1) # 查找上一个工作日 previous_workday = find_workday(delta_days=-1)

🏗️ 项目架构深度解析

chinese-calendar 项目采用清晰的模块化设计，主要模块包括：

chinese_calendar/__init__.py- 主模块入口，导出所有公共接口
chinese_calendar/constants.py- 生成的节假日常量数据定义
chinese_calendar/scripts/data.py- 节假日数据定义和生成逻辑
chinese_calendar/solar_terms.py- 24节气计算相关功能
chinese_calendar/utils.py- 工具函数和辅助方法

🔍 数据来源与权威性保障

该库的所有节假日数据均来源于相关部门发布的官方节假日安排通知，确保数据的准确性和时效性。每年根据最新的官方通知及时更新数据源，保证节假日判断的权威性。

💼 主要应用场景实战

企业考勤系统集成

# 自动判断工作日和节假日，实现考勤自动化 def is_valid_workday(date): return is_workday(date)

财务计算应用优化

# 准确计算工作日相关的利息和费用 def calculate_workday_interest(start_date, end_date, principal): workdays = get_workdays(start_date, end_date, include_weekends=False) return principal * interest_rate * len(workdays)

项目管理系统排期

# 科学排除节假日，优化项目排期 def calculate_project_deadline(start_date, working_days): current_date = start_date while working_days > 0: if is_workday(current_date): working_days -= 1 current_date += datetime.timedelta(days=1) return current_date