pandas.timedelta_range#

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

返回固定频率的TimedeltaIndex,默认频率为day。

参数
start字符串或类似时间增量,默认为无

用于生成时间增量的左界。

end字符串或类似时间增量,默认为无

生成时间增量的右边界。

periodsInt,默认为无

要生成的期间数。

freq字符串或DateOffset,默认为“D”

频率字符串可以有多个,例如‘5H’。

name字符串,默认为无

结果TimedeltaIndex的名称。

closed字符串,默认为无

使间隔相对于给定频率闭合到“左”、“右”或两侧(无)。

退货
TimedeltaIndex

注意事项

四个参数中的 startendperiods ,以及 freq ,则必须恰好指定三个。如果 freq 被省略,则会导致 TimedeltaIndex 将会有 periods 之间的线性间距元素 startend (两边均关闭)。

要了解更多有关频率字符串的信息,请参阅 this link

示例

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

指定 startend ,以及 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)