numpy.busdaycalendar#

class numpy.busdaycalendar(weekmask='1111100', holidays=None)[source]#

一个工作日日历对象,它有效地存储定义 busday 函数族有效日期的信息。

默认有效日期是周一至周五(“工作日”)。busdaycalendar 对象可以指定任何一周的有效日期集,以及可选的“节假日”日期,这些日期始终无效。

创建 busdaycalendar 对象后,无法修改 weekmask 和 holidays。

版本 1.7.0 中的新增功能。

参数:
weekmaskstr 或 array_like of bool,可选

一个七元素数组,指示周一至周日哪些是有效日期。可以指定为长度为七的列表或数组,如 [1,1,1,1,1,0,0];长度为七的字符串,如 '1111100';或像“Mon Tue Wed Thu Fri”这样的字符串,由周几的 3 个字符缩写组成,可选地用空格分隔。有效的缩写是:Mon Tue Wed Thu Fri Sat Sun

holidaysarray_like of datetime64[D],可选

一个日期数组,无论落在哪个星期几,都应被视为无效日期。节假日日期可以按任何顺序指定,NaT(非时间)日期将被忽略。此列表将以适合快速计算有效日期的规范形式保存。

返回值:
outbusdaycalendar

包含指定 weekmask 和 holidays 值的工作日日历对象。

另请参阅

is_busday

返回一个布尔数组,指示有效日期。

busday_offset

应用以有效日期为单位的偏移量。

busday_count

计算半开日期范围内的有效日期数量。

备注

创建 busdaycalendar 对象后,无法修改 weekmask 或 holidays。属性返回内部数据的副本。

示例

>>> import numpy as np
>>> # Some important days in July
... bdd = np.busdaycalendar(
...             holidays=['2011-07-01', '2011-07-04', '2011-07-17'])
>>> # Default is Monday to Friday weekdays
... bdd.weekmask
array([ True,  True,  True,  True,  True, False, False])
>>> # Any holidays already on the weekend are removed
... bdd.holidays
array(['2011-07-01', '2011-07-04'], dtype='datetime64[D]')
属性:
weekmask(副本) 七元素布尔数组

指示有效日期的七元素布尔掩码的副本。

holidays(副本) 已排序的 datetime64[D] 数组

指示额外无效日期的节假日数组的副本。