判断一个日期是否为工作日、节假日,有一个现成的库函数: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 loggerfrom datetime import datetimefrom chinese_calendar import is_workdaydef 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("-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 = 0while True:time_day = time_day - timedelta(days=1)if is_workday(time_day):last_worker_day = time_day.strftime("%Y-%m-%d")breakelif query_time > 20:breakquery_time += 1return 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: -02-18, type: <class 'datetime.date'>-02-18是工作日date_2: -03-19, type: <class 'datetime.date'>-03-19是休息日
3、注意事项
这个库生产环境下使用得注意,如果使用的是一个老版本的库,只能判断当年所在的日期是不是工作,等到第二年,可能就不行,这个时候首先检查下最新版本的库支不支持,检查方法如下:
安装的库版本:chinesecalendar 1.6.1(查看方式: pip3 list | grep chinesecalendar)
在未更新库的情况下,执行时候报错,可以明显的看出报错信息"NotImplementedError: no available data for year , only year between [, ] supported"。
# 进入Python3终端环境测试>>> from chinese_calendar import is_workday>>>>>> from datetime import datetime, date>>> today = date.today()>>> todaydatetime.date(, 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_workdaydate = _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 , only year between [, ] supported>>>
更新为最新的库,最新版本:1.8.0(当前时间:.3.15)
# 更新方式$ pip3 install chinesecalendar -U# 查看当前版本$ pip3 list | grep chinesecalendarchinesecalendar 1.8.0
再次尝试:
>>> from chinese_calendar import is_workday>>> from datetime import datetime, date>>> today = date.today()>>> todaydatetime.date(, 3, 15)>>> is_workday(today)True
我们接着再看着这个库支持的时间范围,可以模拟使用一个几年后的日期作为输入,可以看出此时(.3.15)提示这个库只能支持到的判断。
>>> 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_workdaydate = _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 [, ] supported
参考:
python判断工作日,节假日 - 肖祥 - 博客园
免费节假日 API - 提莫的神秘小站(这种方式也可以参考下,不过在我们公司内部的IDC机器上好像访问不通)