numpy.busday_offset

numpy.busday_offset(dates, offsets, roll='raise', weekmask='1111100', holidays=None, busdaycal=None, out=None)

Сначала дата корректируется, чтобы соответствовать правилу roll, затем к заданным датам применяются смещения, считая количество рабочих дней.

Новая версия 1.7.0.

Параметры:

dates : array_like of datetime64[D] Массив дат для обработки. offsets : array_like of int Массив смещений, который транслируется вместе с dates. roll : {‘raise’, ‘nat’, ‘forward’, ‘following’, ‘backward’, ‘preceding’, ‘modifiedfollowing’, ‘modifiedpreceding’}, optional Как обрабатывать даты, которые не являются рабочими днями. По умолчанию — ‘raise’. ‘raise’ означает, что для нерабочего дня будет возбуждено исключение. ‘nat’ означает, что для нерабочего дня будет возвращено значение NaT (not-a-time). ‘forward’ и ‘following’ означают, что будет взята первая рабочая дата, следующая во времени. ‘backward’ и ‘preceding’ означают, что будет взята первая рабочая дата, предшествующая во времени. ‘modifiedfollowing’ означает, что будет взята первая рабочая дата, следующая во времени, если она не переходит через границу месяца, в противном случае — первая рабочая дата, предшествующая. ‘modifiedpreceding’ означает, что будет взята первая рабочая дата, предшествующая во времени, если она не переходит через границу месяца, в противном случае — первая рабочая дата, следующая. weekmask : str or array_like of bool, optional Массив из семи элементов, указывающий, какие дни с понедельника по воскресенье являются рабочими. Может быть задан как список или массив длины 7, например [1, 1, 1, 1, 1, 0, 0]; строка длиной 7, например ‘1111100’; или строка, подобная “Пн Вт Ср Чт Пт”, состоящая из 3-символьных сокращений дней недели, необязательно разделенных пробелами. Допустимые сокращения: Пн Вт Ср Чт Пт Сб Вс holidays : array_like of datetime64[D], optional Массив дат, которые считаются нерабочими днями. Они могут быть указаны в любом порядке, а даты NaT (not-a-time) игнорируются. Этот список сохраняется в нормализованной форме, подходящей для быстрых вычислений рабочих дней. busdaycal : busdaycalendar, optional Объект busdaycalendar, который задаёт набор рабочих дней. Если этот параметр указан, не должны быть указаны ни weekmask, ни holidays. out : array of datetime64[D], optional Если указан, этот массив заполняется результатом.

Возвращает:

out : array of datetime64[D] Массив с формой, полученной из трансляции dates и offsets, содержащий даты со применёнными смещениями.

См. также

busdaycalendar

Объект, определяющий пользовательский набор рабочих дней.

is_busday

Возвращает булевый массив, указывающий на рабочие дни.

busday_count

Подсчитывает количество рабочих дней в полуоткрытом диапазоне дат.

Примеры

>>> # First business day in October 2011 (not accounting for holidays)
... np.busday_offset('2011-10', 0, roll='forward')
numpy.datetime64('2011-10-03')
>>> # Last business day in February 2012 (not accounting for holidays)
... np.busday_offset('2012-03', -1, roll='forward')
numpy.datetime64('2012-02-29')
>>> # Third Wednesday in January 2011
... np.busday_offset('2011-01', 2, roll='forward', weekmask='Wed')
numpy.datetime64('2011-01-19')
>>> # 2012 Mother's Day in Canada and the U.S.
... np.busday_offset('2012-05', 1, roll='forward', weekmask='Sun')
numpy.datetime64('2012-05-13')

>>> # First business day on or after a date
... np.busday_offset('2011-03-20', 0, roll='forward')
numpy.datetime64('2011-03-21')
>>> np.busday_offset('2011-03-22', 0, roll='forward')
numpy.datetime64('2011-03-22')
>>> # First business day after a date
... np.busday_offset('2011-03-20', 1, roll='backward')
numpy.datetime64('2011-03-21')
>>> np.busday_offset('2011-03-22', 1, roll='backward')
numpy.datetime64('2011-03-23')