Python time.strftime中%Z与%z输出不一致的问题咨询

问题原因 #

这是Python time模块的已知平台相关行为，属于设计限制：

• Python的time.strftime底层依赖系统的C标准库strftime实现，在macOS等平台上，%z格式符不会读取传入的struct_time中的时区信息，而是直接使用系统本地时区的偏移值，导致即使传入UTC时间结构体，%z依然输出本地时区偏移。
• 而%Z能正确输出UTC，是因为struct_time中存储了时区名称信息，C库会读取这部分内容。
• 系统date工具的实现逻辑和Python依赖的C库不同，所以能保持%Z和%z的一致性。

Python官方文档中也明确提到：%z的行为依赖于平台，部分平台不支持从传入的时间结构体获取时区偏移，而是使用当前本地时区的偏移。

解决办法 #

1. 使用datetime模块（推荐） #

datetime模块的时区处理更可靠，不受平台C库限制：

import datetime

# 创建UTC时间对象
utc_dt = datetime.datetime.utcnow().replace(tzinfo=datetime.timezone.utc)
# 格式化输出，%z会正确返回+0000
print(utc_dt.strftime("%Y-%m-%d %H:%M:%S %Z %z"))

2. 手动补全时区偏移（适用于必须使用time模块的场景） #

如果一定要用time模块，可以在确认时间为UTC时，手动拼接+0000：

import time

# 获取UTC时间结构体
utc_time = time.gmtime()
# 格式化时替换%z为固定的+0000
formatted = time.strftime("%Y-%m-%d %H:%M:%S %Z", utc_time) + " +0000"
print(formatted)

3. 使用zoneinfo库（Python 3.9+） #

利用Python自带的zoneinfo模块精准处理时区：

from zoneinfo import ZoneInfo
import datetime

utc_dt = datetime.datetime.now(tz=ZoneInfo("UTC"))
print(utc_dt.strftime("%Y-%m-%d %H:%M:%S %Z %z"))

内容的提问来源于stack exchange，提问作者onlynone