timedelta是datetime模块中表示时间间隔的类,用于日期和时间的算术操作。通过指定天、秒、小时等参数创建对象,可计算过去或未来的日期、比较时间差、执行加减运算。支持days、seconds、microseconds、milliseconds、minutes、hours、weeks参数,正负值分别表示未来和过去时间。常用于缓存过期、登录时长判断、定时任务等场景,使时间处理更直观高效。

Python 中的 timedelta 函数实际上是 datetime.timedelta 类,它用于表示两个日期或时间之间的差值。这个类属于 datetime 模块,能帮助我们进行日期和时间的算术操作。
timedelta 是什么?
timedelta 表示一段时间间隔,比如 2 天、3 小时、30 秒等。你可以用它来:
- 计算几天前或几天后的日期
- 比较两个时间点之间相差多久
- 对 datetime 对象进行加减操作
如何使用 timedelta?
先导入 datetime 模块,然后通过指定参数(如天数、秒、小时等)创建一个 timedelta 对象。
基本语法:
立即学习“Python免费学习笔记(深入)”;
from datetime import timedeltadelta = timedelta(days=1, seconds=0, minutes=0, hours=0, weeks=0)
示例:获取昨天和明天的日期
from datetime import datetime, timedeltanow = datetime.now() yesterday = now - timedelta(days=1) tomorrow = now + timedelta(days=1)
print("今天:", now.date()) print("昨天:", yesterday.date()) print("明天:", tomorrow.date())
支持的时间单位有哪些?
创建 timedelta 时可以传入以下参数:
- days:天数
- seconds:秒数
- microseconds:微秒数
- milliseconds:毫秒数(自动转换为微秒)
- minutes:分钟数
- hours:小时数
- weeks:周数(1 周 = 7 天)
这些参数可以是整数或浮点数,正负都可以,负值表示过去的时间。
常见用途举例
实际开发中常用于:
- 设置缓存过期时间
- 计算用户登录距今多久
- 定时任务中判断是否到达执行时间
例如:判断某个时间是否超过 1 小时前
from datetime import datetime, timedeltaevent_time = datetime(2025, 4, 5, 10, 0, 0) one_hour_ago = datetime.now() - timedelta(hours=1)
if event_time < one_hour_ago: print("事件发生在一小时前")
基本上就这些。timedelta 让时间计算变得简单直观,是处理日期逻辑的重要工具。











