pandas.Timedelta

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

表示一个时间段，即两个日期或时间之间的差异。

Timedelta 是 pandas 中相当于 python 的 datetime.timedelta，在大多数情况下可以与它互换。

参数:

值Timedelta, timedelta, np.timedelta64, str, 或 int

输入值。

单元str, 默认 ‘ns’

如果输入是整数，请表示其单位。

可能的值：

• ‘W’, 或 ‘D’

• ‘天’, 或 ‘天’

• ‘小时’, ‘小时’, ‘小时’, 或 ‘小时’

• ‘分钟’, ‘分钟’, ‘分钟’, 或 ‘分钟’

• ‘秒’, ‘秒’, ‘秒’, 或 ‘秒’

• ‘毫秒’, ‘毫秒’, ‘毫秒’, ‘毫秒’, 或 ‘毫秒’

• ‘微秒’, ‘微秒’, ‘微秒’, ‘微秒’, 或 ‘微秒’

• ‘纳秒’, ‘纳秒’, ‘纳秒’, ‘纳秒’, 或 ‘纳秒’.

自 3.0.0 版本弃用: 允许使用 w, d, MIN, MS, US 和 NS 表示单位已被弃用，取而代之的是使用 W, D, min, ms, us 和 ns。

**kwargs

可用的 kwargs: {days, seconds, microseconds, milliseconds, minutes, hours, weeks}。这些值用于与 datetime.timedelta 兼容的构造。Numpy 的整数和浮点数将被强制转换为 Python 的整数和浮点数。

参见

时间戳

表示单个时间戳。

TimedeltaIndex

timedelta64 数据的不可变索引。

DateOffset

用于日期范围的标准日期增量类型。

to_timedelta

将参数转换为 timedelta。

datetime.timedelta

表示 datetime 模块中的一个时间段。

numpy.timedelta64

表示与 NumPy 兼容的持续时间。

备注

构造函数可以接受值和单位，或者如上所述的kwargs。在初始化期间必须使用其中之一。

.value 属性始终在 ns 中。

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

例子

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

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

在这里，我们使用关键字参数初始化 Timedelta 对象

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

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

属性

asm8	返回一个 numpy timedelta64 数组标量视图。
组件	返回一个类似命名元组的组件。
天数	返回 timedelta 的天数。
max
微秒	返回微秒数 (n)，其中 0 <= n < 1 毫秒。
min
纳秒	返回纳秒数（n），其中 0 <= n < 1 微秒。
分辨率
resolution_string	返回表示最低时间增量分辨率的字符串。
秒	返回 timedelta 的总小时数、分钟数和秒数为秒。
单位	返回 Timedelta 对象的单位。
值	返回 Timedelta 对象的纳秒值。

方法

as_unit(单位[, 允许四舍五入])	将底层的 int64 表示转换为给定的单位。
ceil(freq)	返回一个新的 Timedelta，向上取整到此分辨率。
floor(freq)	返回一个新的 Timedelta，向下取整到此分辨率。
isoformat()	将 Timedelta 格式化为 ISO 8601 持续时间。
round(freq)	将 Timedelta 四舍五入到指定的分辨率。
to_numpy([dtype, copy])	将 Timedelta 转换为 NumPy timedelta64。
to_pytimedelta()	将 pandas 的 Timedelta 对象转换为 python 的 datetime.timedelta 对象。
to_timedelta64()	返回一个具有 'ns' 精度的 numpy.timedelta64 对象。
total_seconds()	持续时间中的总秒数。
视图(dtype)	数组视图兼容性。