Python timedelta 时长换算：seconds 只是余数，总秒数要保住天数与符号
统计任务运行时长时，半小时的样本一切正常，超过一天的任务却突然变短，原因可能只是读错了属性。timedelta 的 seconds 表示归一化后不足一天的秒数分量，并不是整个时间差所包含的秒数。代码能执行，结果也像一个合理数字，所以这个错误很容易混入报表。
先选一个容易心算的样本：一天又两秒半，总时长应为八万六千四百零二点五秒。如果只读取 seconds，拿到的却是二。再把样本改成负一秒，会看到 days 为负一、seconds 为八万六千三百九十九；两个分量合起来才表示原来的负时长。
AI概念配图，非真实界面：以抽象物件说明本文主题，不代表运行结果。
用同一组断言检查三种表示
下面保存为 demo.py，用 Python 3 运行即可。前两段分别验证跨日与负数，第三段把时间差除以一个微秒，使用整除得到精确的整数单位。最后特意比较负数转整数与向下取整，避免换算正确之后又在取整步骤改变业务含义。
示例没有读取当前时间，也不依赖系统时区，因此每次结果一致。它检验的是一个已经得到的时间差如何换单位。真实任务的起止时刻是否使用了正确时钟、时区或记录顺序，需要在生成时间差的上游另行处理。
from datetime import timedelta
span = timedelta(days=1, seconds=2, microseconds=500000)
assert span.seconds == 2
assert span.total_seconds() == 86402.5
print(span.days, span.seconds, span.total_seconds())
negative = timedelta(seconds=-1)
assert (negative.days, negative.seconds) == (-1, 86399)
assert negative.total_seconds() == -1.0
assert negative < timedelta(0)
print(negative.days, negative.seconds, negative.total_seconds())
unit = timedelta(microseconds=1)
exact_us = span // unit
assert exact_us == 86402500000
assert timedelta(microseconds=exact_us) == span
assert timedelta(0) // unit == 0
assert timedelta(microseconds=-1) // unit == -1
half = timedelta(milliseconds=-500)
assert int(half.total_seconds()) == 0
assert half // timedelta(seconds=1) == -1
print(exact_us)
print("duration boundaries passed")总量、分量与取整规则分别选择
第一行输出会保留整天和半秒，第二行说明负时长仍可能带着正的秒数分量。不要用 seconds 是否大于零来判断时间差的正负；直接比较 timedelta(0)，更接近“结束是否早于开始”的业务问题，也不会遗漏微秒。
如果只是绘图或展示秒数，total_seconds 通常直观方便，它返回浮点数。若数据库字段明确存放整数微秒，示例中的单位整除可避免先转浮点再乘回一百万。两种写法服务于不同输出契约，不需要为了统一形式而相互绕行。
负半秒转换为整数会得到零，按一秒整除则得到负一，因为前者向零截断，后者向负无穷取整。展示累计时长、生成时间桶和计算已完成的计费单位，可能需要不同规则。应先决定规则，再挑运算符，不能让代码默认行为替产品做决定。
把边界样本留在时间处理入口
建议为实际函数保留四类样本：不足一秒、跨过一天、恰好为零以及负时长。若业务规定负值无效，就在入口明确拒绝，并记录起止记录的来源；不要用绝对值把异常悄悄转成正常时长，否则顺序错误会长期隐藏。
很大的时间差转为浮点秒数可能丢失微秒精度。官方文档提醒，在多数平台上超过约二百七十年的区间会出现这种限制。对于需要逐微秒比对的长期数据，应保留整数单位或原来的时间差对象，并检查目标存储类型能否容纳。
还有一个常见混淆是把“一天”当成日历中任意一天的实际长度。这里的 timedelta 一天固定按八万六千四百秒参与换算，不能直接代替某地区跨夏令时的日历日规则。报表若按当地日期统计，日期分桶和时长求和应分别定义。
验收时让字段名直接表达单位，例如 duration_us 或 duration_seconds，并在接口说明中写出允许范围和取整方式。只要总量来自完整时间差、符号保留且单位一致，后面的排序、阈值判断和图表展示才有可靠的共同基础。
