pandas.timedelta_range

pandas.timedelta_range(start=None, end=None, periods=None, freq=None, name=None, closed=None)[source]

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

Параметры

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

Левая граница для генерации временных интервалов.

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

Правая граница для генерации временных интервалов.

periods:int, по умолчанию None

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

freq:str или DateOffset, по умолчанию ‘D’

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

name:str, по умолчанию None

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

closed:str, по умолчанию None

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

Возвращает

TimedeltaIndex

Примечания

Из четырех параметров start, end, periods, и freq, ровно три должны быть указаны. Если freq опущено, полученный TimedeltaIndex будет содержать periods линейно расположенных элементов между start и end (закрытый с обеих сторон).

Чтобы узнать больше о строках частоты, пожалуйста, посетите эту ссылку.

Примеры

>>> pd.timedelta_range(start='1 day', periods=4)
TimedeltaIndex(['1 days', '2 days', '3 days', '4 days'],
               dtype='timedelta64[ns]', freq='D')

Параметр closed определяет, какой конец включен. По умолчанию включаются оба конца.

>>> pd.timedelta_range(start='1 day', periods=4, closed='right')
TimedeltaIndex(['2 days', '3 days', '4 days'],
               dtype='timedelta64[ns]', freq='D')

Параметр freq задает частоту TimedeltaIndex. Можно передавать только фиксированные частоты; нефиксированные частоты, такие как ‘M’ (конец месяца), приведут к ошибке.

>>> pd.timedelta_range(start='1 day', end='2 days', freq='6H')
TimedeltaIndex(['1 days 00:00:00', '1 days 06:00:00', '1 days 12:00:00',
                '1 days 18:00:00', '2 days 00:00:00'],
               dtype='timedelta64[ns]', freq='6H')

Укажите start, end, и periods; частота генерируется автоматически (линейно расположенная).

>>> pd.timedelta_range(start='1 day', end='5 days', periods=4)
TimedeltaIndex(['1 days 00:00:00', '2 days 08:00:00', '3 days 16:00:00',
                '5 days 00:00:00'],
               dtype='timedelta64[ns]', freq=None)