pandas.Timedelta#

class pandas.Timedelta(value=<object object>, unit=None, **kwargs)#

表示持续时间，即两个日期或时间之间的差值。

Timedelta是一只Pandas，相当于 Python datetime.timedelta 并且在大多数情况下可以与其互换。

参数

valueTimedelta、TimeDelta、np.timedelta64、str或int

unit字符串，默认为“ns”

如果输入为整数，则表示输入的单位。

可能的值：

**kwargs

可用单位：{天、秒、微秒、毫秒、分钟、小时、周}。构造的值与日期时间.time增量比较。块状整型和浮点型将被强制为巨型整型和浮点型。

注意事项

构造函数既可以接受值也可以接受单位值，也可以接受如上所述的kwargs。在初始化过程中必须使用其中任何一个

这个 .value 属性始终以ns为单位。

如果精度高于纳秒，则持续时间的精度将被截断为纳秒。

示例

在这里，我们使用值和单位来初始化Timedelta对象

>>> td = pd.Timedelta(1, "d")
>>> td
Timedelta('1 days 00:00:00')

在这里，我们使用kwargs初始化Timedelta对象

>>> td2 = pd.Timedelta(days=1)
>>> td2
Timedelta('1 days 00:00:00')

我们看到，无论哪种方式，我们都会得到同样的结果

属性

`asm8`	返回一个NumPy的timedelta64数组标量视图。
`components`	返回一个名为类似元组的组件。
`days`	天数。
`delta`	返回时间增量，单位为纳秒(Ns)，用于内部兼容。
`microseconds`	微秒数(>=0且小于1秒)。
`nanoseconds`	返回纳秒数(N)，其中0<=n<1微秒。
`resolution_string`	返回表示最低时间增量分辨率的字符串。
`seconds`	秒数(>=0且小于1天)。

方法：

`ceil` \(频率)	返回一个新的Timedelta，割让给这个决议。
`floor` \(频率)	返回一个新的Timedelta失败了这个决议。
`isoformat`	将Timedelta格式设置为ISO 8601持续时间，如 `P[n]Y[n]M[n]DT[n]H[n]M[n]S` ，其中 `[n]` 将被这些值替换。
`round` \(频率)	将Timedelta舍入到指定的分辨率。
`to_numpy`	将Timedelta转换为NumPy timedelta64。
`to_pytimedelta`	将PandasTimedelta对象转换为 Python `datetime.timedelta` 对象。
`to_timedelta64`	返回一个精度为‘ns’的numpy.timedelta64对象。
`total_seconds`	持续时间内的总秒数。
`view`	阵列视图兼容性。

pandas.DatetimeTZDtype.tz

pandas.Timedelta.asm8