Python学习笔记：timedelta类相关函数
一、介绍
timedelta 类表示时间差，可以直接实例化，也可以由两个 datetime 类型的数据作差得到。
缘起于求两个时间差，并需要转换为特定的单位（天、小时、分钟等），遂产生此需求。
二、导入
导入具体模块为：
from datetime import timedelta
参数为：
# days seconds microseconds milliseconds minutes hours weeks
# 实例化
td = timedelta(days=1, hours=8)
# datetime.timedelta(days=1, seconds=28800)
print(td)
# 1 day, 8:00:00
通过以下可以查看相应属性和方法。
dir(timedelta)
'''
['__abs__',
'__add__',
'__bool__',
'__class__',
'__delattr__',
'__dir__',
'__divmod__',
'__doc__',
'__eq__',
'__floordiv__',
'__format__',
'__ge__',
'__getattribute__',
'__gt__',
'__hash__',
'__init__',
'__init_subclass__',
'__le__',
'__lt__',
'__mod__',
'__mul__',
'__ne__',
'__neg__',
'__new__',
'__pos__',
'__radd__',
'__rdivmod__',
'__reduce__',
'__reduce_ex__',
'__repr__',
'__rfloordiv__',
'__rmod__',
'__rmul__',
'__rsub__',
'__rtruediv__',
'__setattr__',
'__sizeof__',
'__str__',
'__sub__',
'__subclasshook__',
'__truediv__',
'days',
'max',
'microseconds',
'min',
'resolution',
'seconds',
'total_seconds']
'''
三、实例
# 导入模块
from datetime import timedelta, datetime
begin_time = '2022-11-20 23:16:00'
end_time = '2022-11-25 15:16:17'
# 转换为时间格式
begin_time = datetime.strptime(begin_time, '%Y-%m-%d %H:%M:%S')
end_time = datetime.strptime(end_time, '%Y-%m-%d %H:%M:%S')
# 求时间差
print(end_time - begin_time)
# 4 days, 16:00:17
1.days 天数
返回时间差的天数。
(end_time - begin_time).days # 4
2.seconds 秒数
返回时间差的秒数。
注意：此秒数并非整体时间差，而是时间部分的秒数！
(end_time - begin_time).seconds # 57617
3.microseconds 毫秒数
返回时间差的毫秒数。
(end_time - begin_time).microseconds # 0
# 因为原始数据没有毫秒
days、seconds、microseconds 输出的是时间差对应位置的分量，而不是讲时间差转换单位的结果。
4.min 下限
返回时间差的下限（无论timedelta对象是什么返回都一样）。
(end_time - begin_time).min # datetime.timedelta(days=-999999999)
print((end_time - begin_time).min) # -999999999 days, 0:00:00
5.max 上限
返回时间差的上限（无论timedelta对象是什么返回都一样）。
(end_time - begin_time).max # datetime.timedelta(days=999999999, seconds=86399, microseconds=999999)
print((end_time - begin_time).max) # 999999999 days, 23:59:59.999999
6.resolution 精度
返回时间差的精度。
(end_time - begin_time).resolution # datetime.timedelta(microseconds=1)
print((end_time - begin_time).resolution) # 0:00:00.000001
7.total_seconds 总秒数
toal_seconds 是 timedelta 对象的唯一一个方法。
将时间差转换为秒的单位进行返回。
后续如需转换为其他单位需自行乘以相应的系数。
(end_time - begin_time).total_seconds() # 403217.0
工作中常在数据框中进行转换。
# 转换单位
data['时间_diff_day'] = data['时间_diff'].map(lambda x: x.days)
data['时间_diff_second'] = data['时间_diff'].map(lambda x: x.total_seconds())
data['时间_diff_hour'] = data['时间_diff_second'] / 3600
注意 total_seconds 为方法，需要加括号，其他为属性，无须添加括号。
参考链接：【Python】timedelta类详解
