chinese-calendar 库提供 2004 至 2026 年中国法定节假日数据支持。安装后通过 is_holiday 和 is_workday 函数判断日期状态，支持调休识别。功能涵盖节假日列表获取、补班检测及 24 节气查询。适用于企业考勤系统、财务利息计算等场景。生产环境建议锁定版本并处理异常，批量查询可优化性能。该库基于官方通知更新，专注于中国地区假期逻辑。
chinese-calendar 库作为专业的 Python 节假日解决方案，为开发者提供了从 2004 年到 2026 年的完整中国节假日数据支持，让节假日计算变得简单高效。
使用 pip 命令快速安装 chinesecalendar 库：
pip install chinesecalendar
或者从源码安装最新版本：
git clone https://github.com/jisuanke/chinese-calendar
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
class AttendanceCalculator:
def validate_work_date(self, check_date):
"""验证日期是否为有效工作日"""
return is_workday(check_date)
def get_workday_count(self, start_date, end_date):
"""计算工作日总数"""
workday_count = 0
current_date = start_date
while current_date <= end_date:
if is_workday(current_date):
workday_count += 1
current_date += datetime.timedelta(days=1)
return workday_count
基于工作日计算财务利息：
def calculate_business_day_interest(principal, rate, start_date, days):
"""按工作日计算利息"""
total_interest = 0
current_date = start_date
for _ in range(days):
if is_workday(current_date):
daily_interest = principal * rate / 365
total_interest += daily_interest
current_date += datetime.timedelta(days=1)
return total_interest
获取节假日分布统计：
from chinese_calendar import get_holidays
def analyze_year_holidays(year):
"""分析年度节假日模式"""
start = datetime.date(year, 1, 1)
end = datetime.date(year, 12, 31)
holidays = get_holidays(start, end, include_weekends=False)
return {
'year': year,
'holiday_count': len(holidays),
'holiday_dates': [h.strftime('%m-%d') for h in holidays]
}
除了法定节假日，还支持传统 24 节气：
from chinese_calendar import get_solar_terms
# 获取年度节气信息
solar_terms = get_solar_terms(
datetime.date(2024, 1, 1),
datetime.date(2024, 12, 31)
)
当查询超出支持年份的日期时：
def safe_check_holiday(date_to_check):
"""安全检查节假日状态"""
try:
return is_holiday(date_to_check)
except NotImplementedError:
# 处理超出范围的日期
return False
确保节假日数据准确性：
# 每年年底更新获取最新数据
pip install -U chinesecalendar
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
解析常见 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