如何优雅将ISO格式UTC时间转为本地时区时间（Python）

我需要将无时区标识的ISO格式UTC时间（如2024-09-05T00:00:00）转换为本地时区时间（如2024-09-05T09:00:00+0900），要求仅使用Python原生库完成，但遇到了以下问题：

核心问题：无时区标识的ISO字符串解析 #

执行以下代码时，fromisoformat解析无时区的字符串得到的是无时区信息的naive datetime对象，而非默认识别为UTC：

>>> import time
>>> import datetime
>>> import pytz
>>> time.tzname
('JST', 'JST')
>>> utc_time = "2024-09-05T00:00:00"
>>> utc_dt = datetime.datetime.fromisoformat(utc_time)
>>> utc_dt.strftime("%Y-%m-%dT%H:%M:%S%z")
'2024-09-05T00:00:00'

当尝试将其转换为东京时区时，时间并未按预期增加9小时：

>>> utc_dt.astimezone(pytz.timezone("Asia/Tokyo")).strftime("%Y-%m-%dT%H:%M:%S%z")
'2024-09-05T00:00:00+0900'

原因是Python会将naive datetime默认视为本地时区时间，因此转换操作只是添加时区标识，不会改变时间数值。

临时解决方案：拼接UTC标识Z #

通过给输入字符串添加Z后缀，让fromisoformat直接识别为UTC时间：

>>> utc_time = "2024-09-05T01:09:11" + "Z"
>>> utc_dt = datetime.datetime.fromisoformat(utc_time)
>>> utc_dt.strftime("%Y-%m-%dT%H:%M:%S%z")
'2024-09-05T01:09:11+0000'
>>> utc_dt.astimezone(pytz.timezone("Asia/Tokyo")).strftime("%Y-%m-%dT%H:%M:%S%z")
'2024-09-05T10:09:11+0900'

但这种字符串拼接的方式不够优雅，希望有更规范的实现方式。

奇怪的偏移错误 #

直接用replace给naive datetime设置pytz时区时，出现了非预期的偏移值：

>>> datetime.datetime.fromisoformat(utc_time).replace(tzinfo=pytz.timezone("Asia/Tokyo")).strftime("%Y-%m-%dT%H:%M:%S%z")
'2024-09-05T00:00:00+0919'

这是因为pytz的时区对象包含该时区的历史偏移记录（如东京时区早年曾使用+09:19的偏移），直接用replace会调用旧偏移值，而非当前标准偏移。

优雅的解决方法 #

方法1：原生库显式设置UTC时区 #

无需第三方库，直接给解析后的naive datetime设置UTC时区，再转换到目标时区：

>>> utc_time = "2024-09-05T00:00:00"
# 解析并显式标记为UTC时间
>>> utc_dt = datetime.datetime.fromisoformat(utc_time).replace(tzinfo=datetime.timezone.utc)
# 转换到东京时区（手动指定偏移）
>>> utc_dt.astimezone(datetime.timezone(datetime.timedelta(hours=9))).strftime("%Y-%m-%dT%H:%M:%S%z")
'2024-09-05T09:00:00+0900'

如果要自动获取系统本地时区，可替换为：

>>> local_tz = datetime.datetime.now().astimezone().tzinfo
>>> utc_dt.astimezone(local_tz).strftime("%Y-%m-%dT%H:%M:%S%z")
'2024-09-05T09:00:00+0900'

方法2：使用pytz的localize方法（若依赖pytz） #

用pytz提供的localize方法给naive datetime添加上UTC时区，避免历史偏移问题：

>>> utc_dt = pytz.utc.localize(datetime.datetime.fromisoformat(utc_time))
>>> utc_dt.astimezone(pytz.timezone("Asia/Tokyo")).strftime("%Y-%m-%dT%H:%M:%S%z")
'2024-09-05T09:00:00+0900'

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