pandas.timedelta_range

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

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

Parameters:

start:str или timedelta-подобное значение, по умолчанию None

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

end:str или timedelta-подобное значение, по умолчанию None

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

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

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

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

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

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

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

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

Указывает, какой конец интервала закрыт относительно заданной частоты: ‘left’, ‘right’ или оба (‘None’).

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

Указывает желаемое разрешение результата.

Добавлена в версии 2.0.0.

Returns:

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)

Укажите единицы измерения

>>> pd.timedelta_range("1 Day", periods=3, freq="100000D", unit="s")
TimedeltaIndex(['1 days', '100001 days', '200001 days'],
               dtype='timedelta64[s]', freq='100000D')