pandas.timedelta_range#

pandas.timedelta_range(начало=None, end=None, periods=None, freq=None, имя=None, закрыт=None, *, единица=None)[источник]#

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

Параметры:

началоstr или подобный timedelta, по умолчанию None: Левая граница для генерации timedeltas.
endstr или подобный timedelta, по умолчанию None: Правая граница для генерации timedeltas.
periodsint, по умолчанию None: Количество периодов для генерации.
freqstr, Timedelta, datetime.timedelta или DateOffset, по умолчанию 'D': Строки частоты могут иметь множители, например, '5h'.
имяstr, по умолчанию None: Имя результирующего TimedeltaIndex.
закрытstr, по умолчанию None: Сделать интервал замкнутым относительно заданной частоты с 'левой', 'правой' или обеих сторон (None).
единицаstr, по умолчанию None: Укажите желаемое разрешение результата.

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

Возвращает:

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')

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

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

The 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')