Python脚本如何判断系统节假日

wen python案例 2026-06-27 240

本文目录导读：

Python脚本如何判断系统节假日

使用 chinesecalendar 库（推荐）
使用 holidays 库（国际通用）
使用 API 接口（最准确）
自定义节假日数据（离线方案）
综合最佳实践
推荐方案

在Python中判断系统节假日,我推荐几种实用方法：

使用 chinesecalendar 库（推荐）

这是最常用的中国节假日判断库：

# 安装：pip install chinesecalendar
from datetime import date
import chinesecalendar
def is_holiday(date_obj):
    """判断是否为节假日"""
    from chinesecalendar import is_holiday
    return is_holiday(date_obj)
# 使用示例
today = date.today()
print(f"{today} 是节假日吗？{is_holiday(today)}")
# 判断特定日期
test_date = date(2024, 2, 10)  # 2024年春节
print(f"{test_date} 是节假日吗？{is_holiday(test_date)}")

使用 holidays 库（国际通用）

# 安装：pip install holidays
import holidays
# 中国节假日
cn_holidays = holidays.China()  # 注意：此库可能不是特别准确
# 检查特定日期
def check_with_holidays(date_obj):
    return date_obj in cn_holidays
# 使用示例
test_date = date(2024, 1, 1)
print(f"{test_date} 是节假日：{test_date in cn_holidays}")

使用 API 接口（最准确）

import requests
from datetime import date, datetime
def check_holiday_api(date_str=None):
    """
    使用节假日API判断
    推荐：http://timor.tech/api/holiday/
    """
    if date_str is None:
        date_str = date.today().strftime('%Y-%m-%d')
    url = f"http://timor.tech/api/holiday/info/{date_str}"
    try:
        response = requests.get(url, timeout=5)
        data = response.json()
        if data.get('code') == 0:
            holiday_info = data['type']
            # type: 0=工作日, 1=周末, 2=节假日, 3=调休上班
            return {
                'is_holiday': holiday_info['type'] in [1, 2],
                'detail': holiday_info['name'] if holiday_info['type'] == 2 else None,
                'is_weekend': holiday_info['type'] == 1,
                'is_workday': holiday_info['type'] == 0
            }
    except Exception as e:
        print(f"API请求失败: {e}")
        return None
# 使用示例
result = check_holiday_api()
if result:
    print(f"今天是否节假日：{result['is_holiday']}")

自定义节假日数据（离线方案）

import json
from datetime import date
class ChinaHolidayChecker:
    def __init__(self, holiday_data_file=None):
        """初始化，可以从文件加载，也可以硬编码"""
        self.holidays = {
            # 2024年节假日
            '2024-01-01': '元旦',      # 元旦
            '2024-02-10': '春节',      # 春节
            '2024-02-11': '春节',
            '2024-02-12': '春节',
            '2024-04-04': '清明节',     # 清明节
            '2024-05-01': '劳动节',     # 劳动节
            '2024-06-10': '端午节',     # 端午节
            '2024-09-17': '中秋节',     # 中秋节
            '2024-10-01': '国庆节',     # 国庆节
            '2024-10-02': '国庆节',
            '2024-10-03': '国庆节',
        }
        # 调休上班日
        self.work_weekends = {
            '2024-02-04': '春节调休',
            '2024-02-18': '春节调休',
            '2024-04-07': '清明调休',
            '2024-04-28': '劳动节调休',
            '2024-05-11': '劳动节调休',
            '2024-09-14': '中秋调休',
            '2024-09-29': '国庆调休',
            '2024-10-12': '国庆调休',
        }
        if holiday_data_file:
            self.load_from_file(holiday_data_file)
    def is_holiday(self, date_obj):
        """判断是否为节假日"""
        date_str = date_obj.strftime('%Y-%m-%d')
        # 检查是否为调休上班日
        if date_str in self.work_weekends:
            return False
        # 检查是否为节假日
        if date_str in self.holidays:
            return True
        # 检查是否为周末
        return date_obj.weekday() >= 5
    def get_holiday_name(self, date_obj):
        """获取节假日名称"""
        date_str = date_obj.strftime('%Y-%m-%d')
        if date_str in self.holidays:
            return self.holidays[date_str]
        elif date_str in self.work_weekends:
            return f"调休上班({self.work_weekends[date_str]})"
        elif date_obj.weekday() == 5:
            return "周六"
        elif date_obj.weekday() == 6:
            return "周日"
        else:
            return "工作日"
# 使用示例
checker = ChinaHolidayChecker()
today = date.today()
print(f"{today} 是节假日：{checker.is_holiday(today)}")
print(f"{today} 名称：{checker.get_holiday_name(today)}")

综合最佳实践

class SmartHolidayChecker:
    """智能节假日判断器，结合多种方案"""
    def __init__(self):
        self.decorator_checker = None
        self.api_checker = None
        self.local_checker = ChinaHolidayChecker()
        # 尝试导入第三方库
        try:
            from chinesecalendar import is_holiday
            self.decorator_checker = is_holiday
        except ImportError:
            pass
    def is_holiday(self, date_obj):
        """综合判断是否节假日"""
        # 1. 优先使用第三方库
        if self.decorator_checker:
            try:
                return self.decorator_checker(date_obj)
            except:
                pass
        # 2. 尝试API
        if self.api_checker:
            result = self.api_checker(date_obj.strftime('%Y-%m-%d'))
            if result:
                return result['is_holiday']
        # 3. 使用本地数据
        return self.local_checker.is_holiday(date_obj)
# 使用
checker = SmartHolidayChecker()
print(f"{checker.is_holiday(date.today())}")