datetime模块更适合处理带日期的结构化时间,提供datetime、date等类支持日期计算和时区转换;time模块更贴近系统接口,提供高精度计时器如perf_counter()和monotonic(),但不支持时区和直接算术运算。

datetime 模块更适合处理带日期的结构化时间
datetime 模块提供 datetime、date、time、timedelta 等类,天然支持年月日+时分秒组合,适合做日期计算、格式化、时区转换等任务。比如 datetime.now() 返回完整时间戳,datetime(2023, 12, 25) + timedelta(days=7) 能直接加减天数。
而 time 模块的 time.time() 只返回浮点型 Unix 时间戳(秒级),time.struct_time 虽含年月日字段,但不支持算术运算,也不能直接比较大小——你得先转成 time.mktime() 或 calendar.timegm() 才能参与计算。
常见错误:用 time.strptime() 解析字符串后直接加减小时,结果报 TypeError: unsupported operand type(s) —— 因为返回的是 struct_time,不是可运算对象。
time 模块更贴近系统时间接口和高精度计时
time 模块直接封装 C 标准库的 clock_gettime()、gettimeofday() 等调用,所以它提供更底层、更可控的时间操作。例如:
立即学习“Python免费学习笔记(深入)”;
-
time.perf_counter()是 Python 中精度最高、最稳定的计时器,适合性能测量,不受系统时钟调整影响 -
time.monotonic()保证单调递增,适合超时控制或间隔等待 -
time.sleep()的行为比datetime相关方案(如轮询)更可靠、更省资源
datetime 没有等效的高精度计时能力;它所有“现在”都基于 time.time() 构建,本身不提供额外精度。
时区处理必须用 datetime + zoneinfo(Python 3.9+)或 pytz
time 模块几乎不支持时区:它的 time.localtime() 和 time.gmtime() 只能按本地或 UTC 解释时间戳,无法绑定任意时区,也没有 astimezone() 这类方法。
datetime 本身也默认是“naive”(无时区),但配合 zoneinfo.ZoneInfo 就能构造“aware”对象:
from datetime import datetime
from zoneinfo import ZoneInfo
dt = datetime(2024, 1, 1, 12, 0, tzinfo=ZoneInfo("Asia/Shanghai"))
dt.astimezone(ZoneInfo("UTC")) # 正确转换别试图用 time.timezone 或 time.altzone 手动偏移——它们只反映当前进程的本地时区偏移,且不处理夏令时切换。
跨平台兼容性与 Python 版本要注意
time 模块在所有 Python 版本中行为稳定,但部分函数(如 time.clock())在 Python 3.8 已弃用,3.12 彻底移除;Windows 下 time.perf_counter() 和 time.process_time() 的语义与 Linux 不同。
datetime 在 3.6+ 支持 %G/%u 等 ISO 周相关格式符;但 zoneinfo 是 3.9 新增,旧版本必须装 pytz 或用 datetime.timezone 手写固定偏移——后者不能处理 DST。
真正容易被忽略的是:当你用 datetime.fromtimestamp() 传入一个带微秒的时间戳,它在某些系统上会因 time.localtime() 精度限制丢失微秒;而 datetime.utcfromtimestamp() 同样受此影响。需要纳秒级精度?只能回到 time.time_ns() + 手动构造 datetime。










