Python datetime 模块 timedelta 函数

Python datetime 模块

Python timedelta() 函数用于表示时间差，用于日期加减。

语法

timedelta(days=0, seconds=0, minutes=0, hours=0, weeks=0)

参数

关键字参数：days、seconds、microseconds、minutes、hours、weeks，默认 0。

返回值

返回 timedelta 时间差对象，可与 datetime 相加减，或用 .days/.total_seconds() 取数值。

示例

from datetime import datetime, timedelta

now = datetime.now()
tomorrow = now + timedelta(days=1)
last_week = now - timedelta(weeks=1)
in_3h = now + timedelta(hours=3)

print(tomorrow)
print(last_week)

# 计算两个时间的差
t1 = datetime(2024, 1, 1)
t2 = datetime(2024, 1, 10)
diff = t2 - t1
print(diff.days)              # 9
print(diff.total_seconds())   # 777600.0

注意事项

timedelta 能做 +、-、比较。diff.days 是整天数，total_seconds() 是精确总秒数。