datetime面向人类时间,支持时区、格式化和运算;time面向系统时间,返回自1970年起的秒数,精度高但无语义。业务逻辑优先用datetime,性能敏感场景用time。

datetime 是面向人类时间的,time 是面向系统时间的
你写 datetime.now() 想拿到“今天下午 3 点 27 分”,而调用 time.time() 实际拿到的是自 1970-01-01 UTC 起的秒数(浮点型)。前者带时区、可格式化、能做加减;后者只是个数字,精度高但没语义。多数业务逻辑(比如计算“用户登录距今 2 小时内”)该用 datetime,而性能敏感或需要和 C 库/OS 交互的场景(如 time.sleep()、time.perf_counter())才该碰 time。
timezone 处理完全不在一个层级上
datetime 支持 tzinfo 子类和 zoneinfo.ZoneInfo(Python 3.9+),能真正表示带时区的时间点;time 模块里只有 time.timezone、time.altzone 这种只读偏移量常量,连当前时区都拿不准——它依赖环境变量,且不处理夏令时切换。
- 用
datetime解析 ISO 时间字符串(如"2024-05-20T15:30:00+08:00")直接支持时区 -
time.strptime()返回的struct_time默认是本地时区,且无法携带 UTC 偏移信息 -
time.mktime()和time.localtime()都基于系统本地时区,跨时区传参极易出错
time.struct_time 和 datetime 对象不能混用
常见错误是把 time.localtime() 的返回值当成 datetime 用,结果报 TypeError: unsupported operand type(s) for +: 'time.struct_time' and 'datetime.timedelta'。它们是完全不同的类型,没有隐式转换。
- 从
struct_time构造datetime:用datetime(*time.localtime()[:6])(注意只取前 6 个字段) - 反向转换:用
dt.timetuple(),但注意它不保留微秒和时区信息 - 更安全的做法是统一走
datetime.fromtimestamp()或datetime.timestamp()
time.time() 返回 float,但精度不等于准确度
time.time() 看似返回“精确到纳秒”的浮点数,实际取决于系统时钟源和调用频率。在容器或虚拟机里,它可能被调度延迟拖慢;Windows 上默认只到 15ms 级别。而 time.perf_counter() 才是真正适合测间隔的函数——它单调、无跳变、精度更高。
立即学习“Python免费学习笔记(深入)”;
- 别用
time.time()做高频轮询或超时控制,改用time.perf_counter() -
time.time_ns()(Python 3.7+)返回整数纳秒,但依然受系统限制,不是“绝对精确” - 跨进程共享时间戳必须用
datetime.utcnow().timestamp()或明确序列化为 ISO 字符串
真正麻烦的从来不是“哪个模块更好”,而是混用时连错误提示都不告诉你哪错了——比如把 time.time() 结果直接塞进 datetime.fromtimestamp() 却忘了它默认按本地时区解释,结果线上服务器和本地开发机输出差 8 小时。









