Python工作日类库Busines Holiday介绍

Posted 2020-09-06 bladestone

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

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

4. 总结

business_holiday的包是非常强大了，基本覆盖了我们关于假期的需求，大家可以自行尝试一下如何使用。如有问题，也可以反馈给我。

同时，也非常欢迎大家关注我的个人blog： http://blog.csdn.net/blueheart20

终于到底了，万恶的分割线.......

---------------------------------------------------------------------------------------------------------------