Python datetime 与 time 模块的核心差异

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 小时。