Python判断指定日期是不是中国工作日/节假日

判断一个日期是否为工作日、节假日，有一个现成的库函数：chinesecalendar

chinesecalendar · PyPI

1、安装与升级

1.1 安装

pip3 install chinesecalendar

1.2 升级

pip install -U chinesecalendar

官方库说明：GitHub - LKI/chinese-calendar: 判断一天是不是法定节假日/法定工作日（查看节假日安排）

由于次年的节假日安排，取决于国务院发布的日程。 所以本项目一般会在国务院更新以后，发布新的版本。 按照以往的经验，一般是每年的 11月 前后发布新版本。

啥意思呢？明年的节假日现在还拿不到，只有等到当年的11月左右才能拿到，这个库对应会升级，也就是需要用户每年手动更新下这个库。（生产环境慎用）

2、代码示例 

demo.py

from logzero import logger
from datetime import datetime
from chinese_calendar import is_workday


def isWorkdays(date_value):
  """
  # 判断是否是法定节假日
  """
  if is_workday(date_value):
    print("{}是工作日".format(date_value))
  else:
    print("{}是休息日".format(date_value))


# 当前日期
date_1 = datetime.now().date()
print("date_1: {}, type: {}".format(date_1, type(date_1)))

isWorkdays(date_1)

# 人工输入日期
date_2 = datetime.strptime("2022-03-19", '%Y-%m-%d').date()
print("date_2: {}, type: {}".format(date_2, type(date_2)))

isWorkdays(date_2)


# 2、获取上一个工作日
def get_last_work_day(time_day):
    """
    # 获取上一个工作日
    """
    last_worker_day = ""
    
    # 最多查询20次
    query_time = 0
    
    while True:
        time_day = time_day - timedelta(days=1)
        
        if is_workday(time_day):
            last_worker_day = time_day.strftime("%Y-%m-%d")
            break
        elif query_time > 20:
            break
        
        query_time += 1
            
    return last_worker_day


# 日期
time_day = date.today()

# 判断是工作日
if is_workday(time_day):
    logger.info("{}是工作日！".format(time_day))
else:
    logger.info("{}不是工作日！".format(time_day))
    
last_work_day = get_last_work_day(time_day)
logger.info("上一个工作日是: {}".format(last_work_day))

运行结果：

date_1: 2022-02-18, type: <class 'datetime.date'>
2022-02-18是工作日
date_2: 2022-03-19, type: <class 'datetime.date'>
2022-03-19是休息日

3、注意事项

这个库生产环境下使用得注意，如果使用的是一个老版本的库，只能判断当年所在的日期是不是工作，等到第二年，可能就不行，这个时候首先检查下最新版本的库支不支持，检查方法如下：

2022年安装的库版本：chinesecalendar  1.6.1（查看方式: pip3 list | grep chinesecalendar）

在未更新库的情况下，2023年执行时候报错，可以明显的看出报错信息"NotImplementedError: no available data for year 2023, only year between [2004, 2022] supported"。

# 进入Python3终端环境测试


>>> from chinese_calendar import is_workday
>>>
>>> from datetime import datetime, date
>>> today = date.today()
>>> today
datetime.date(2023, 3, 15)
>>>
>>> is_workday(today)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/home/sokf/.jumbo/lib/python3.6/site-packages/chinese_calendar/utils.py", line 60, in is_workday
    date = _validate_date(date)
  File "/home/sokf/.jumbo/lib/python3.6/site-packages/chinese_calendar/utils.py", line 36, in _validate_date
    "no available data for year {}, only year between [{}, {}] supported".format(date.year, min_year, max_year)
NotImplementedError: no available data for year 2023, only year between [2004, 2022] supported
>>>

更新为最新的库，最新版本：1.8.0（当前时间：2023.3.15）

# 更新方式
$ pip3 install chinesecalendar -U


# 查看当前版本
$ pip3 list | grep chinesecalendar
chinesecalendar           1.8.0

再次尝试：

>>> from chinese_calendar import is_workday
>>> from datetime import datetime, date
>>> today = date.today()
>>> today
datetime.date(2023, 3, 15)
>>> is_workday(today)
True

我们接着再看着这个库支持的时间范围，可以模拟使用一个几年后的日期作为输入，可以看出此时（2023.3.15）提示这个库只能支持到2023年的判断。

>>> from chinese_calendar import is_workday
>>> from datetime import datetime, date, timedelta
>>> today = datetime.now() + timedelta(days=1365)
>>> is_workday(today)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/home/sokf/.jumbo/lib/python3.6/site-packages/chinese_calendar/utils.py", line 61, in is_workday
    date = _validate_date(date)
  File "/home/sokf/.jumbo/lib/python3.6/site-packages/chinese_calendar/utils.py", line 37, in _validate_date
    "no available data for year {}, only year between [{}, {}] supported".format(date.year, min_year, max_year)
NotImplementedError: no available data for year 2026, only year between [2004, 2023] supported

参考：

python判断工作日，节假日 - 肖祥 - 博客园

免费节假日 API - 提莫的神秘小站 （这种方式也可以参考下，不过在我们公司内部的IDC机器上好像访问不通）