67-1、语法

# 67、pandas.timedelta_range函数

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

Return a fixed frequency TimedeltaIndex with day as the default.

Parameters:

startstr or timedelta-like, default None

Left bound for generating timedeltas.

endstr or timedelta-like, default None

Right bound for generating timedeltas.

periodsint, default None

Number of periods to generate.

freqstr, Timedelta, datetime.timedelta, or DateOffset, default ‘D’

Frequency strings can have multiples, e.g. ‘5h’.

namestr, default None

Name of the resulting TimedeltaIndex.

closedstr, default None

Make the interval closed with respect to the given frequency to the ‘left’, ‘right’, or both sides (None).

unitstr, default None

Specify the desired resolution of the result.

New in version 2.0.0.

Returns:

TimedeltaIndex

67-2、参数

67-2-1、start(可选，默认值为None)：str或Timedelta，生成时间差范围的起始点，可以是表示时间差的字符串(如'1 days')或Timedelta对象，如果未指定，则必须指定periods参数。

67-2-2、end(可选，默认值为None)：str或Timedelta，生成时间差范围的结束点，与start参数类似，可以是字符串或Timedelta对象，如果指定了end，则生成的时间差范围将包括这个结束点(取决于closed参数的值)。

67-2-3、periods(可选，默认值为None)：int，时间差的数量，如果指定了periods，则生成的时间差范围将包含指定数量的等间隔时间差；如果同时指定了start和end，则periods可以被忽略或用于计算频率。

67-2-4、freq(可选，默认值为None)：str或DateOffset，时间差的频率，可以是如'D'(天)、'H'(小时)、'T'(分钟)等频率字符串，或者是DateOffset对象。如果未指定，则频率将根据start、end和periods 参数自动计算(如果可能的话)。

67-2-5、name(可选，默认值为None)：str，返回的TimedeltaIndex的名称。

67-2-6、closed(可选，默认值为None)：{'left', 'right'}，指示区间是“左闭右开”('left')还是“左开右闭”('right')，这仅在同时指定了start和end时有效。默认是 'right'，即区间包括结束点但不包括起始点(在逻辑上，因为时间差通常从0开始计数)。

67-2-7、unit(可选，默认值为None)：从Pandas 1.1.0开始不推荐使用，因为freq参数已经足够灵活来指定时间差的单位，如果同时指定了freq和unit，freq将优先。

67-3、功能

        用于生成时间序列的时间差(timedelta)范围的一个函数，该函数允许你根据起始时间、结束时间、时间差的数量、时间频率等参数来创建一个TimedeltaIndex，这个索引包含了等间隔的时间差。

67-4、返回值

        返回值是一个Pandas TimedeltaIndex对象，该对象具有以下特点：

67-4-1、类型：TimedeltaIndex是Pandas中专门用于存储时间差索引的类型，它提供了丰富的日期时间操作功能。

67-4-2、内容：返回的TimedeltaIndex对象包含了根据指定参数生成的等间隔时间差序列，这些时间差按照指定的频率排列，并且每个时间差都对应着一个具体的时间长度(如1天、2小时等)。

67-4-3、属性：TimedeltaIndex对象具有多个属性，如dtype(数据类型，表示时间差的纳秒表示)、freq(频率，表示时间差的生成频率)、inferred_freq(推断的频率，当没有明确指定freq时，Pandas 会尝试推断时间差序列的频率)等，这些属性描述了时间差索引的基本信息。

67-4-4、操作：TimedeltaIndex对象支持多种操作，如索引、切片、算术运算(如加法、减法)等，这些操作使得用户能够方便地对时间差索引进行进一步的处理和分析。

67-5、说明

        无

67-6、用法

67-6-1、数据准备

无

67-6-2、代码示例

# 67、pandas.timedelta_range函数

# 67-1、使用start和periods

import pandas as pd

# 从0天0小时开始，生成包含5个时间差的序列，每个时间差为1天

td_range = pd.timedelta_range(start='0 days', periods=5, freq='D')code>

print(td_range, end='\n\n')code>

# 67-2、使用start、end和freq

import pandas as pd

# 从1小时开始，到10小时结束，每小时一个时间差

td_range = pd.timedelta_range(start='1 hours', end='10 hours', freq='H')code>

print(td_range, end='\n\n')code>

# 67-3、使用end和periods

import pandas as pd

# 从0天开始，到3天结束，包含4个时间差（注意：这里不直接指定freq，但Pandas会尝试推断）

td_range = pd.timedelta_range(end='3 days', periods=4)code>

print(td_range, end='\n\n')code>

# 67-4、指定name参数

import pandas as pd

# 生成时间差序列，并指定索引名称

td_range = pd.timedelta_range(start='0 days', periods=5, freq='D', name='Time_Differences')code>

print(td_range)

67-6-3、结果输出