pandas.tseries.offsets.CustomBusinessMonthBegin

classpandas.tseries.offsets.CustomBusinessMonthBegin

Класс-подкласс DateOffset, представляющий пользовательский(ие) рабочий месяц(и).

Увеличивает значения между датами начала месяца.

Параметры:

n:int, по умолчанию 1

Количество месяцев.

normalize:bool, по умолчанию False

Нормализовать даты начала до полуночи перед генерацией диапазона дат.

weekmask:str, по умолчанию ‘Mon Tue Wed Thu Fri’

Маска дней недели для рабочих дней, передаётся в numpy.busdaycalendar.

holidays:list

Список/массив дат, исключаемых из набора рабочих дней, передаётся в numpy.busdaycalendar.

calendar:np.busdaycalendar

Календарь для интеграции.

offset:timedelta, по умолчанию timedelta(0)

Временной сдвиг для применения.

См. также

DateOffset

Стандартный тип приращения дат.

Примеры

В примере ниже используются параметры по умолчанию.

>>> ts = pd.Timestamp(2022, 8, 5)
>>> ts + pd.offsets.CustomBusinessMonthBegin()
Timestamp('2022-09-01 00:00:00')

Начальный рабочий месяц может быть указан параметром weekmask. Для преобразования возвращаемого объекта datetime в строковое представление используется функция strftime() в следующем примере.

>>> import datetime as dt
>>> freq = pd.offsets.CustomBusinessMonthBegin(weekmask="Wed Thu")
>>> pd.date_range(dt.datetime(2022, 7, 10), dt.datetime(2022, 12, 18),
...               freq=freq).strftime('%a %d %b %Y %H:%M')
Index(['Wed 03 Aug 2022 00:00', 'Thu 01 Sep 2022 00:00',
       'Wed 05 Oct 2022 00:00', 'Wed 02 Nov 2022 00:00',
       'Thu 01 Dec 2022 00:00'],
       dtype='object')

Используя календарь рабочих дней NumPy, можно определить пользовательские праздничные дни.

>>> import datetime as dt
>>> bdc = np.busdaycalendar(holidays=['2022-08-01', '2022-09-30',
...                                   '2022-10-31', '2022-11-01'])
>>> freq = pd.offsets.CustomBusinessMonthBegin(calendar=bdc)
>>> pd.date_range(dt.datetime(2022, 7, 10), dt.datetime(2022, 11, 10), freq=freq)
DatetimeIndex(['2022-08-02', '2022-09-01', '2022-10-03', '2022-11-02'],
               dtype='datetime64[ns]', freq='CBMS')

Атрибуты

base	Возвращает копию объекта смещения, вызвавшего метод, с n=1 и всеми другими атрибутами, равными.
calendar
cbday_roll	Определяет функцию сдвига по умолчанию, которая будет вызвана в методе apply.
freqstr	Возвращает строку, представляющую частоту.
holidays
kwds	Возвращает словарь дополнительных параметров для смещения.
m_offset
month_roll	Определяет функцию сдвига по умолчанию, которая будет вызвана в методе apply.
n
name	Возвращает строку, представляющую базовую частоту.
nanos
normalize
offset	Псевдоним для self._offset.
rule_code
weekmask

Методы

copy()	Возвращает копию частоты.
is_anchored()	(УСТЕРЕЖЕН) Возвращает boolean значение, указывающее, является ли частота единичной частотой (n=1).
is_month_end(ts)	Возвращает boolean значение, указывающее, наступает ли отметка времени в конце месяца.
is_month_start(ts)	Возвращает boolean значение, указывающее, наступает ли отметка времени в начале месяца.
is_on_offset(dt)	Возвращает boolean значение, указывающее, пересекается ли отметка времени с этой частотой.
is_quarter_end(ts)	Возвращает boolean значение, указывающее, наступает ли отметка времени в конце квартала.
is_quarter_start(ts)	Возвращает boolean значение, указывающее, наступает ли отметка времени в начале квартала.
is_year_end(ts)	Возвращает boolean значение, указывающее, наступает ли отметка времени в конце года.
is_year_start(ts)	Возвращает boolean значение, указывающее, наступает ли отметка времени в начале года.
rollback(dt)	Смещает предоставленную дату назад к следующему смещению только если она не находится на смещении.
rollforward(dt)	Смещает предоставленную дату вперёд к следующему смещению только если она не находится на смещении.