pandas.timedelta_range#

pandas.timedelta_range(start=None, end=None, periods=None, freq=None, name=None, closed=None, *, unit=None)[源代码][源代码]#

返回一个固定频率的 TimedeltaIndex，默认以天为单位。

参数:

开始str 或 timedelta-like, 默认 None: 生成时间增量的左边界。
结束str 或 timedelta-like, 默认 None: 生成时间增量的右边界。
periodsint, 默认为 None: 要生成的周期数。
freqstr, Timedelta, datetime.timedelta, 或 DateOffset, 默认 ‘D’: 频率字符串可以有倍数，例如 ‘5h’。
名字str, 默认为 None: 生成的 TimedeltaIndex 的名称。
关闭str, 默认为 None: 使区间相对于给定的频率在 ‘左’、’右’ 或两侧（None）闭合。
单元str, 默认为 None: 指定所需的结果分辨率。

Added in version 2.0.0.

返回:

TimedeltaIndex: 固定频率，默认以天为单位。

参见

date_range: 返回一个固定频率的 DatetimeIndex。
period_range: 返回一个固定频率的 PeriodIndex。

注释

在四个参数 start、end、periods 和 freq 中，必须恰好指定三个。如果省略 freq，生成的 TimedeltaIndex 将在 start 和 end 之间（两边闭合）线性间隔 periods 个元素。

要了解更多关于频率字符串的信息，请参见此链接。

示例

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