Python timedelta.seconds 计算超过一天的时长时少了整天

两个时间相差超过一天，Python 相减后读取 .seconds，得到的数值却不到 86,400；倒过来相减，结果甚至仍是正数。这里要检查读取的是 timedelta 的秒分量，还是整个时长的总秒数。

timedelta.seconds 的范围始终是 0 到 86399。完整时长由 days、seconds 和 microseconds 共同表示；要转换成总秒数，应使用 total_seconds()。以下示例适用于 Python 3.2 及以后版本。

先看完整的 timedelta

下面用固定时长说明差别，不依赖当前系统时间：

from datetime import timedelta

duration = timedelta(days=1, seconds=30, microseconds=500000)

print(duration.days)           # 预期 1
print(duration.seconds)        # 预期 30
print(duration.microseconds)   # 预期 500000
print(duration.total_seconds())  # 预期 86430.5

.seconds 返回 30，并不是把总时长计算错了，而是只取出归一化表示中的一部分。一天和半秒仍在另外两个属性中。不要通过给 .seconds 的结果强制转成浮点数来修复；float(30) 也不会补回这两部分。

如果代码原来是 elapsed = (finished - started).seconds，在已经确认两个时间的含义与相减顺序正确后，可以改为：

elapsed = (finished - started).total_seconds()

started 和 finished 是原程序中已经取得的 datetime 对象，不能把这个片段单独执行并期待自动产生时间。它修正的是取值方式，不会替输入补齐时区或修复错误的先后顺序。

负时长也不能靠 seconds 判断

负数同样会被归一化为天、秒和微秒，例如：

from datetime import timedelta

duration = timedelta(seconds=-1)
print(duration.days)            # 预期 -1
print(duration.seconds)         # 预期 86399
print(duration.total_seconds()) # 预期 -1.0

这里表示的是 -1 天 + 86399 秒，合计负一秒。若用 .seconds > 60 判断是否已经超时，就可能把未来时间或反向相减得到的负差值误判为接近一天。

业务若不接受负时长，应明确检查完整时长是否小于 timedelta(0)，再根据数据契约拒绝、记录或修正来源。不要直接取绝对值把相减方向错误隐藏起来。

只判断阈值时，可以直接比较时长

判断任务是否已经超过五分钟，不一定需要先转成秒：

from datetime import timedelta

elapsed = finished - started
is_overdue = elapsed > timedelta(minutes=5)

这个片段同样沿用已经定义的两个时间。它会比较完整时长，包含天和微秒；如果业务是“达到五分钟就过期”，应使用 >=，不要在修属性时顺手改变边界约定。

对同一份数据，分别覆盖不足一天、恰好一天、超过一天、负差值、零值和带微秒的差值。只用几秒钟的正差值测试，容易让 .seconds 与总秒数恰好一致，从而漏掉错误。

总秒数是浮点表示，输入含义仍要单独确认

total_seconds() 返回浮点数。通常用于秒级时长很方便，但极大的时间跨度会丢失微秒精度，多数平台上超过约 270 年时就不能依赖它保留每一微秒。如果接口要求完整的整数微秒，可以从三个整数分量组合：

total_microseconds = (
    (duration.days * 86400 + duration.seconds) * 1000000
    + duration.microseconds
)

这个表达式假设 duration 已经是 timedelta。不要先把总秒数取整再乘回微秒，那会丢掉小数部分。

datetime 相减之前仍需统一时间含义。naive 与 aware 混用会报错；跨夏令时的当地墙上时间也不能仅靠换成 total_seconds() 就保证符合实际流逝时间。如果要计算两个具体时刻的差，应先依据原数据的时区语义正确转换，不能随意删掉或伪造时区标记。

修改前保留原计算逻辑和代表性输入，确认调用方是否接受浮点数，以及保存字段、阈值判断和展示单位是否一致。若旧结果已用于报表或计费，修复代码不会自动重算历史值，需要按仍保留的原始起止时间核对受影响范围；无法确认输入含义时，不应批量覆盖旧数据。