pandas.Timedelta

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

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

Timedelta 是 pandas 中 python 的 datetime.timedelta 的等效项，在大多数情况下可以与之互换。

Parameters:

valueTimedelta、timedelta、np.timedelta64、str 或 int

unitstr，默认为 ‘ns’

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

可能的值：

• ‘W’ 或 ‘D’

• ‘days’ 或 ‘day’

• ‘hours’, ‘hour’, ‘hr’ 或 ‘h’

• ‘minutes’, ‘minute’, ‘min’ 或 ‘m’

• ‘seconds’, ‘second’, ‘sec’ 或 ‘s’

• ‘milliseconds’, ‘millisecond’, ‘millis’, ‘milli’ 或 ‘ms’

• ‘microseconds’, ‘microsecond’, ‘micros’, ‘micro’ 或 ‘us’

• ‘nanoseconds’, ‘nanosecond’, ‘nanos’, ‘nano’ 或 ‘ns’。

自 2.2.0 版本弃用: 值为 ‘H’, ‘T’, ‘S’, ‘L’, ‘U’, 和 ‘N’ 已弃用，建议使用 ‘h’, ‘min’, ‘s’, ‘ms’, ‘us’, 和 ‘ns’。

**kwargs

可用关键字参数：{days, seconds, microseconds, milliseconds, minutes, hours, weeks}。用于与 datetime.timedelta 兼容的构造。Numpy 的整数和浮点数将被强制转换为 python 的整数和浮点数。

Notes

构造函数可以同时接受 value 和 unit，或者如上所示的关键字参数。初始化时必须使用其中一种。

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

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

Examples

这里我们使用值和单位初始化 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')

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

Attributes

asm8	返回一个 numpy timedelta64 数组标量视图。
components	返回一个类似命名元组的 components。
days	返回 timedelta 的天数。
max
microseconds
min
nanoseconds	返回纳秒数（n），其中 0 <= n < 1 微秒。
resolution
resolution_string	返回表示最低 timedelta 分辨率的字符串。
seconds	返回 timedelta 的总小时、分钟和秒数（以秒为单位）。
unit
value

Methods

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