chinese-calendar 终极指南：轻松搞定中国节假日自动识别

chinese-calendar 是一个专门用于判断中国法定节假日和工作日的 Python 库，支持从 2004 年到 2026 年的完整节假日数据。无论你是开发考勤系统、财务计算工具，还是项目管理系统，这个库都能帮你快速实现节假日智能识别功能。

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

项目核心亮点

chinese-calendar 拥有几个突出的特点，让它成为处理中国节假日的最佳选择：

• 数据权威可靠- 所有节假日数据均来自官方发布的权威通知
• 覆盖范围广泛- 支持 2004 年至 2026 年，包含春节延长假期等特殊情况
• 智能调休识别- 能够准确识别法定节假日的调休安排
• 轻量级设计- 库文件体积小，依赖简单，集成方便

快速上手配置

一键安装方法

使用 pip 命令即可快速完成安装：

pip install chinesecalendar

年度数据更新

由于节假日安排每年可能有所调整，建议在每年年底执行版本升级，获取最新的节假日数据：

pip install -U chinesecalendar

核心功能详解

基础日期类型判断

chinese-calendar 最核心的功能就是判断某一天是工作日还是节假日：

import datetime from chinese_calendar import is_holiday, is_workday # 检查 2024 年国庆节 national_day = datetime.date(2024, 10, 1) print(f"2024 年国庆节是节假日吗？{is_holiday(national_day)}") # 输出：True print(f"2024 年国庆节是工作日吗？{is_workday(national_day)}") # 输出：False

节假日详细信息获取

除了判断是否是节假日，你还可以获取具体的节日名称：

import chinese_calendar as calendar # 获取节假日详情 is_holiday, holiday_name = calendar.get_holiday_detail(national_day) if is_holiday: print(f"今天是 {holiday_name} 假期")

调休日智能识别

中国的节假日安排中经常有调休情况，chinese-calendar 也能准确识别：

from chinese_calendar import is_in_lieu # 判断是否为调休日 is_adjustment_day = is_in_lieu(datetime.date(2024, 2, 4))

实际应用场景

企业考勤系统集成

在企业考勤系统中，chinese-calendar 可以帮助自动排除法定节假日，准确计算实际出勤天数：

from chinese_calendar import get_workdays def calculate_attendance_days(start_date, end_date): """计算指定时间段内的实际出勤天数""" workdays = get_workdays(start_date, end_date, include_weekends=False) return len(list(workdays)) # 计算 2024 年 1 月份的实际出勤天数 jan_start = datetime.date(2024, 1, 1) jan_end = datetime.date(2024, 1, 31) attendance_days = calculate_attendance_days(jan_start, jan_end)

财务计算应用

在金融领域，利息计算通常只考虑工作日：

from chinese_calendar import find_workday def calculate_workday_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

进阶使用技巧

节假日时间段统计

如果你需要统计某个时间段内的所有节假日：

from chinese_calendar import get_holidays # 获取 2024 年所有节假日（包含周末） start_2024 = datetime.date(2024, 1, 1) end_2024 = datetime.date(2024, 12, 31) all_2024_holidays = get_holidays(start_2024, end_2024, include_weekends=True)

工作日智能查找

快速查找相对于某个日期的前一个或后一个工作日：

from chinese_calendar import find_workday # 查找下一个工作日 next_business_day = find_workday(datetime.date.today(), 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 - 工具函数和辅助方法

常见问题解答

Q: 这个库支持哪些年份的节假日数据？A: 目前支持 2004 年至 2026 年的完整节假日数据。

Q: 如何获取最新的节假日数据？A: 建议每年 11 月前后执行pip install -U chinesecalendar来更新数据。

Q: 调休日是如何判断的？A: 库会根据官方发布的调休安排进行准确识别。

Q: 这个库是否包含周末的判断？A: 是的，库提供了灵活的选项，你可以选择是否包含周末在节假日统计中。

使用注意事项

在使用 chinese-calendar 时，有几点需要特别注意：

1. 政策依赖性- 节假日安排以官方最新通知为准
2. 时间范围限制- 超出 2004-2026 范围的日期无法判断
3. 版本更新- 建议定期更新以获取最新的节假日安排

通过 chinese-calendar 库，你可以轻松地在各种 Python 应用中集成中国法定节假日的智能判断功能，大大提升开发效率和系统准确性。无论是简单的日期判断，还是复杂的业务逻辑计算，这个库都能为你提供可靠的支持。

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