【转载】Python工作日类库Busines Holiday介绍

引言: 在日常工作中,经常会碰到类似的场景,需要计算在某个时间段内的工作日以及确定某天是否为工作日,这里的介绍的工具包将很好的解决这个问题。

 

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) 是否是假日