datetime.now() 返回的是无时区信息的 naive 时间,非系统时区时间;正确做法是显式传入 zoneinfo 或 pytz 时区对象,避免直接调用 astimezone() 或依赖 tz 环境变量。

datetime.now() 没指定 tzinfo 就是本地时间,但本地时间不等于系统时区
很多人以为 datetime.now() 返回的是“当前系统时区的时间”,其实它返回的是“无时区信息的 naive datetime”,哪怕你系统设了 Asia/Shanghai,datetime.now() 的 tzinfo 仍是 None。这会导致后续做时区转换、比较、序列化时出错——比如存进数据库或传给前端,时间就悄悄偏了 8 小时。
正确做法是显式绑定时区:
- 用
zoneinfo.ZoneInfo(Python 3.9+):datetime.now(ZoneInfo("Asia/Shanghai")) - 旧版本用
pytz:datetime.now(pytz.timezone("Asia/Shanghai")),但注意必须用.localize()而非直接传入tz参数,否则夏令时处理会错 - 避免用
time.localtime()或time.tzname推断时区,它们不可靠,尤其在容器或 CI 环境中常为空或错误
astimezone() 在 naive datetime 上直接调用会报错
astimezone() 只能作用于 aware datetime(即带 tzinfo 的实例)。对 datetime.now() 这类 naive 时间直接调用,会抛出 ValueError: astimezone() cannot be applied to a naive datetime。
常见误操作是先取 now = datetime.now(),再写 now.astimezone(ZoneInfo("UTC")) —— 这行不通。
立即学习“Python免费学习笔记(深入)”;
Python v2.4版chm格式的中文手册,内容丰富全面,不但是一本手册,你完全可以把她作为一本Python的入门教程,教你如何使用Python解释器、流程控制、数据结构、模板、输入和输出、错误和异常、类和标准库详解等方面的知识技巧。同时后附的手册可以方便你的查询。
- 正确路径:先确保是 aware 时间,再转换:
datetime.now(ZoneInfo("Asia/Shanghai")).astimezone(ZoneInfo("UTC")) - 如果只有 naive 时间且确定其本意是某个时区(比如日志里没带时区但约定为北京时间),得先用
.replace(tzinfo=...),但注意replace()是硬赋值,不校验合法性;而ZoneInfo支持夏令时自动计算,pytz的localize()才是安全方式 - 别用
utcnow()当“UTC 时间”用:它返回的仍是 naive 时间,不是 UTC aware 时间
ZoneInfo 和 pytz 混用会引发隐性 bug
ZoneInfo 和 pytz 的时区对象不能互换。把 pytz.timezone("Asia/Shanghai") 传给 ZoneInfo 构造器,或反过来,不会报错,但时区行为可能错乱——比如夏令时偏移量算错、跨年转换异常。
尤其在团队项目中,有人用 pytz 初始化时间,有人用 ZoneInfo 做转换,时间差几小时都查不出原因。
- Python 3.9+ 统一优先用
zoneinfo.ZoneInfo,它是标准库,无需额外安装,且设计更合理 - 如果必须兼容老代码或依赖
pytz的库(如旧版django),请在边界处做显式转换,例如用dt.replace(tzinfo=None).astimezone(pytz.UTC),而不是直接传对象 -
ZoneInfo不支持pytz那种“固定偏移 + 名称”构造(如pytz.FixedOffset(480)),需要改用timezone(timedelta(hours=8))(但这是固定偏移,不处理夏令时)
读取系统时区环境变量 TZ 并不可靠
很多脚本试图通过 os.environ.get("TZ") 获取当前时区,再传给 pytz.timezone()。但这个变量在 Linux 上默认不设置,在 Docker 容器里几乎总是空,在 macOS 上行为也不一致。
更糟的是,即使设置了 TZ=Asia/Shanghai,datetime.now() 仍不会自动使用它——Python 不读这个变量。
- 不要依赖
TZ环境变量推断时区,它和 Python 的时区逻辑完全脱钩 - 真正可靠的来源只有两个:明确配置(如配置文件里的
TIME_ZONE = "Asia/Shanghai")或操作系统 API(如zoneinfo.available_timezones()结合/etc/timezone或timedatectl输出,但需 root 权限且跨平台不一致) - 在云环境或容器中,默认应设为 UTC,所有业务时间统一用 UTC 存储,展示时再转本地时区——这是最可控的做法









