引言: 在日常工作中,经常会碰到类似的场景,需要计算在某个时间段内的工作日以及确定某天是否为工作日,这里的介绍的工具包将很好的解决这个问题。
1. 工具包Business Holiday介绍
其提供了非常简单易用的计算工作日的接口,并允许用户指定特定日期为假期,从而将其从当前的工作日中剔除。
项目主页: https://pypi.python.org/pypi/business_calendar/
文档首页: http://py-business-calendar.readthedocs.io/en/latest/
2. 功能分析与介绍
Case 1: 计算在某个时间段之内的工作日天数
from business_calendar import Calendar, MO, TU, WE, TH, FR
import datetime
date1 = datetime.datetime(2013,1,10)
# normal calendar, no holidays
cal = Calendar()
date2 = datetime.datetime(2013,3,20)
print('%s days between %s and %s' % (cal.busdaycount(date1, date2), date1, date2))
功能描述: 计算2013/1/10之后的25天之内的工作日天数:
49 days between 2013-01-10 00:00:00 and 2013-03-20 00:00:00
Case 2: 计算若干工作日之后的日期
from business_calendar import Calendar, MO, TU, WE, TH, FR
import datetime
date1 = datetime.datetime(2013,1,10)
cal = Calendar()
date2 = cal.addbusdays(date1, 25)
print("The specified date will be %s" % date2)
功能描述: 计算25个工作日之后的日期
The specified date will be 2013-02-14 00:00:00
Case 3: 结合假期,以及星期的概念,计算工作日:
from business_calendar import Calendar, MO, TU, WE, TH, FR
import datetime
date1 = datetime.datetime(2013,1,10)
# normal calendar, no holidays
cal = Calendar(workdays=[MO,TU,WE,TH], holidays=['2013-01-17'])
date2 = datetime.datetime(2013,3,20)
print('%s days between %s and %s' % (cal.busdaycount(date1, date2), date1, date2))
功能描述: 指定周一到周四工作,1.17日是公众假期,计算会有多少个工作日:
38 days between 2013-01-10 00:00:00 and 2013-03-20 00:00:00
3. 功能分析
在该类库中,有workday和businessday的概念:
addbusydays(date, offset) 其将考虑holidays公休假的因素
addworkdays(date, offset) 忽略公休假的因素
busdaycount(date1, date2) 计算两个时间点直接的工作日
range(date1, date2) 返回工作日列表, 考虑假期因素
isworkday(date) 是否是工作日,忽略公休假的因素
isbusday(date) 是否工作日,考虑公休假
isHoliday(date) 是否是假日