pandas.bdate_range

pandas.bdate_range(start=None, end=None, periods=None, freq='B', tz=None, normalize=True, name=None, weekmask=None, holidays=None, closed=_NoDefault.no_default, inclusive=None, **kwargs)[source]

Возвращает индекс Datetime с фиксированной частотой, по умолчанию с днями недели.

Параметры

start:строка или datetime-подобный объект, по умолчанию None

Левая граница для генерации дат.

end:строка или datetime-подобный объект, по умолчанию None

Правая граница для генерации дат.

periods:целое число, по умолчанию None

Количество периодов для генерации.

freq:строка или DateOffset, по умолчанию ‘B’ (рабочий день)

Строки частоты могут иметь кратность, например, ‘5H’.

tz:строка или None

Имя часового пояса для возвращаемого локализованного DatetimeIndex, например Asia/Beijing.

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

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

name:строка, по умолчанию None

Имя результирующего DatetimeIndex.

weekmask:строка или None, по умолчанию None

Маска дней недели для рабочих дней, передается в numpy.busdaycalendar, используется только при передаче пользовательских строк частоты. Значение по умолчанию None эквивалентно ‘Mon Tue Wed Thu Fri’.

holidays:список или None, по умолчанию None

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

closed:строка, по умолчанию None

Сделать интервал закрытым относительно заданной частоты к ‘левому’, ‘правому’ или обеим сторонам (None).

Устарело начиная с версии 1.4.0: Аргумент closed устарел для стандартизации входных данных границ. Используйте inclusive вместо него, чтобы задать каждую границу как закрытую или открытую.

inclusive:{“both”, “neither”, “left”, “right”}, по умолчанию “both”

Включать границы; Устанавливать каждую границу как закрытую или открытую.

Введено в версии 1.4.0.

**kwargs

Для совместимости. Не влияет на результат.

Возвращает

DatetimeIndex

Примечания

Из четырех параметров: start, end, periods, и freq, должны быть указаны ровно три. Указание freq является обязательным для bdate_range. Используйте date_range если указание freq нежелательно.

Дополнительную информацию о строках частоты можно найти по этой ссылке.

Примеры

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

>>> pd.bdate_range(start='1/1/2018', end='1/08/2018')
DatetimeIndex(['2018-01-01', '2018-01-02', '2018-01-03', '2018-01-04',
           '2018-01-05', '2018-01-08'],
          dtype='datetime64[ns]', freq='B')