如何计算两个datetime对象的时分秒差值？处理timedelta天数及负数问题

问题背景 #

从JSON API响应中提取结束时间字符串，转换为datetime对象后与当前UTC时间计算得到timedelta类型的剩余时间。原代码通过字符串分割提取时分秒，在timedelta包含天数（如1 day, 4:55:22.761359或-1 days, 23:59:08.45766）时会执行失败。

原代码片段：

from datetime import datetime

end_time_string = data['endTime']
date_format = "%Y%m%dT%H%M%S.%fZ"
end_time = datetime.strptime(end_time_string, date_format)
current_time = datetime.utcnow()
time_remaining = end_time - current_time

# 原提取代码：存在天数时会报错
hours, minutes, seconds = map(float, str(time_remaining).split(':'))

解决方案 #

不要依赖timedelta的字符串表示，直接通过其total_seconds()属性计算时分秒，同时处理正负时间差的情况：

from datetime import datetime

end_time_string = data['endTime']
date_format = "%Y%m%dT%H%M%S.%fZ"
end_time = datetime.strptime(end_time_string, date_format)
current_time = datetime.utcnow()
time_remaining = end_time - current_time

# 计算总秒数，处理正负
total_seconds = time_remaining.total_seconds()
sign = -1 if total_seconds < 0 else 1
abs_seconds = abs(total_seconds)

# 分解为时分秒
hours = int(abs_seconds // 3600)
remaining_after_hours = abs_seconds % 3600
minutes = int(remaining_after_hours // 60)
seconds = remaining_after_hours % 60

# 恢复符号
hours *= sign

print(f"剩余时间：{hours}小时 {minutes}分钟 {seconds:.6f}秒")

原理说明 #

• total_seconds()会返回timedelta对应的总秒数，包含天数转换后的秒数，完全避开字符串格式解析的问题
• 通过判断总秒数的正负来保留时间差的符号，确保负数时间（结束时间已过）也能正确提取时分秒
• 利用整数除法和取余运算，将总秒数精准分解为小时、分钟、秒，结果不受天数影响

内容的提问来源于stack exchange，提问作者Lzypenguin