pandas.Timedelta #

熊猫类 Timedelta ( value=<object object> , unit=None , **kwargs ) #

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

Timedelta 是 pandas 的 python 的等价物datetime.timedelta ,并且在大多数情况下可以与之互换。

参数
Timedelta、timedelta、np.timedelta64、str 或 int
单位str,默认'ns'

如果输入是整数,则表示输入的单位。

可能的值:

  • '单词'

  • ‘日’或‘日’

  • “小时”、“小时”、“hr”或“h”

  • “分钟”、“分钟”、“分钟”或“米”

  • “秒”、“秒”、“秒”或“s”

  • “毫秒”、“毫秒”、“毫秒”、“毫秒”或“毫秒”

  • “微秒”、“微秒”、“微”、“微”或“我们”

  • “纳秒”、“纳秒”、“纳秒”、“纳秒”或“纳秒”。

自版本 2.2.0 起已弃用:HTSLUN已弃用,取而代之的是值hminsmsusns

**夸格

可用的 kwargs:{天、秒、微秒、毫秒、分钟、小时、周}。构造值与 datetime.timedelta 兼容。 Numpy 整数和浮点数将被强制转换为 Python 整数和浮点数。

笔记

构造函数可以接受上面的 value 和 unit 或 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

返回 timedelta 的天数。

max

microseconds

min

nanoseconds

返回纳秒数 (n),其中 0 <= n < 1 微秒。

resolution

resolution_string

返回表示最低时间增量分辨率的字符串。

seconds

返回 timedelta 的总小时数、分钟数和秒数(以秒为单位)。

unit

value

方法

as_unit(单位[, round_ok])

将底层 int64 表示形式转换为给定单位。

ceil(频率)

返回此分辨率上限的新 Timedelta。

floor(频率)

返回一个以此分辨率为底的新 Timedelta。

isoformat()

将 Timedelta 格式化为 ISO 8601 持续时间。

round(频率)

将 Timedelta 舍入到指定的分辨率。

to_numpy([数据类型,复制])

将 Timedelta 转换为 NumPy timedelta64。

to_pytimedelta()

将 pandas Timedelta 对象转换为 pythondatetime.timedelta对象。

to_timedelta64()

返回精度为 'ns' 的 numpy.timedelta64 对象。

total_seconds()

持续时间的总秒数。

view(数据类型)

数组视图兼容性。