Python datetime astimezone时区转换陷阱与正确用法

Oliver

发布时间：2026-10-16| 6人浏览过

原创

本文详解Python中datetime模块astimezone方法处理时区时的常见陷阱。当naive datetime对象直接调用astimezone时，Python会误将其视为本地时间，导致转换结果错误。通过replace(tzinfo=...)显式指定时区后，即可实现正确的跨时区时间转换。

Python标准库datetime的astimezone方法在设置时区时容易引发误解，本文通过实例解析其工作原理及常见错误。

datetime模块主要包含四个核心组件：

date类用于处理年、月、日等日期信息。
time类用于处理时、分、秒及微秒等时间信息。
datetime类结合日期和时间，处理同时包含日期和时间的场景。
timedelta类用于表示两个日期或时间之间的间隔。

获取当前本地时间与UTC时间的方法如下：

# 从 datetime 中导入 datetime 模块。
from datetime import datetime
 
 
utc_time = datetime.utcnow()    # utcnow()获取世界标准时间。
print(f'1、UTC时间为：{utc_time}')
 
local_time = datetime.now()     # now() 获取本地时间。
print(f'1、本地时间为：{local_time}')

执行上述代码后，输出结果如下：

UTC时间显示为：2019-06-26 10:58:24.730439

本地时间显示为：2019-06-26 18:58:24.730439

对比可见，本地时间比UTC世界标准时间快8小时。

接下来定义具体的时区对象：

通过timezone()函数可以创建时区对象，其参数通常由timedelta()提供。

timedelta()函数主要用于计算日期的加减运算。

该函数的参数说明如下：

timedelta([days[, seconds[, microseconds[, milliseconds[, minutes[, hours[, weeks]]]]]]])

从构造函数定义可知，所有参数均为可选，且默认值均为0。

from datetime import timezone, timedelta
 
beijing = timezone(timedelta(hours=8))
print(f'1、北京时区为：{beijing}')
 
Tokyo = timezone(timedelta(hours=9))
print(f'2、东京时区为：{Tokyo}')
 
New_York = timezone(timedelta(hours=-4))
print(f'3、纽约时区为：{New_York}')
 
utc = timezone.utc
print(f'4、世界标准时区为：{utc}')

运行上述代码后的结果如下：

北京时区表示为：UTC+08:00

东京时区表示为：UTC+09:00

纽约时区表示为：UTC-04:00

世界标准时区表示为：UTC

由此可见，所定义的时区均是基于UTC时区进行加减运算得出的结果。

在UTC时间基础上，使用astimezone()方法进行时区转换：

首先展示一个常见的错误操作示例：

utc_time = datetime.utcnow()
print(f'UTC时间为：{utc_time}')
print(f'本地时间为：{datetime.now()}')
 
time_beijing = utc_time.astimezone(beijing)
time_tokyo = utc_time.astimezone(Tokyo)
time_newyork = utc_time.astimezone(New_York)
 
print('1、更改时区为北京后的时间：', time_beijing)
print('2、更改时区为东京后的时间：', time_tokyo)
print('3、更改时区为纽约后的时间：', time_newyork)

执行该错误代码后的输出结果如下：

UTC时间为：2019-06-26 11:55:18.150625 本地时间为：2019-06-26 19:55:18.150625 1、更改时区为北京后的时间： 2019-06-26 11:55:18.150625+08:00 # 后面的 +08:00 只是显示时区， # 这里表示的时间就是 11 点，而不是加了 8 后的 19 点。 2、更改时区为东京后的时间： 2019-06-26 12:55:18.150625+09:00 # 东京时间早于北京时间1小时。 3、更改时区为纽约后的时间： 2019-06-25 23:55:18.150625-04:00 # 纽约时间晚于北京时间12小时。

观察运行结果发现，北京时间与本地时间相差8小时，且与UTC时间数值一致，这表明时区调整结果存在错误。

在正常逻辑下，北京时间应当与本地时间保持一致。

# 通过tzinfo属性查看utc_time的时区信息

print(utc_time.tzinfo)

输出结果为：None。由此可知上述日期转换错误的原因在于：

当对utc_time调用astimezone()修改时区时，由于utc_time的时区属性为None（即naive datetime），Python模块会默认将其视为本地时区。

因为本地时区即为UTC+08:00，所以当执行time_beijing = utc_time.astimezone(beijing)时，时区信息虽被标记为+08:00，但时间数值并未发生实际转换，仍保持为2019-06-26 11:55:18.150625。

当执行time_tokyo = utc_time.astimezone(Tokyo)时，系统会先将时间视为UTC时间（2019-06-26 3:55:18.150625+00:00），再叠加东京时区，最终变为：2019-06-26 12:55:18.150625+09:00。

正确的时区转换方法如下：

首先利用replace(tzinfo=时区对象)方法强制修改utc_time的时区属性：

utc_time = datetime.utcnow()    # 获取当前 UTC 时间
print(f'UTC时间为：{utc_time}')
local_time = datetime.now()     # 获取当前本地时间
print(f'本地时间为：{local_time}')
 
utc = timezone.utc                                  # 获取 UTC 的时区对象
utc_time = datetime.utcnow().replace(tzinfo=utc)    # 强制转换加上 UTC 时区。此处敲黑板，需要特别注意。
                                                    # replace的tzinfo参数为时区对象，所以
                                                    # 也可以这样 replace(tzinfo=timezone(timedelta(hours=0))
print(f'1、强制更改后的UTC时间为：{utc_time}')
 
time_beijing = utc_time.astimezone(beijing)
time_newyork = utc_time.astimezone(New_York)
time_tokyo = utc_time.astimezone(Tokyo)
print('2、更改时区为北京后的时间：', time_beijing)
print('3、获取时区信息：', time_beijing.tzinfo)
print('4、更改时区为东京后的时间：', time_tokyo)
print('5、获取时区信息：', time_tokyo.tzinfo)
print('6、更改时区为纽约后的时间：', time_newyork)
print('7、获取时区信息：', time_newyork.tzinfo)

执行上述正确代码后的结果如下：

UTC时间为：2019-06-26 12:29:10.178907 本地时间为：2019-06-26 20:29:10.178907 1、强制更改后的UTC时间为：2019-06-26 12:29:10.178907+00:00 # 这里为上面的UTC时间加上了 +00：00 2、更改时区为北京后的时间： 2019-06-26 20:29:10.178907+08:00 # 此时的北京时间就和上面的本地时间一样了。 3、获取时区信息： UTC+08:00 4、更改时区为东京后的时间： 2019-06-26 21:29:10.178907+09:00 # 东京时间比北京时间早1小时，也正常。 5、获取时区信息： UTC+09:00 6、更改时区为纽约后的时间： 2019-06-26 08:29:10.178907-04:00 # 纽约时间比UTC时间晚4小时，也是正常的。 7、获取时区信息： UTC-04:00

注意：astimezone()方法在修改时区时，会相应地调整日期和时间数值。

而replace(tzinfo=时区)仅修改时区属性，不改变原有的日期和时间数值。

此时若使用timestamp()将各时间转换为时间戳，三者的时间戳应当相同，即：

time_beijing.timestamp() == time_tokyo.timestamp() == time_newyork.timestamp()

因为这三个时间仅是不同时区的表示形式，它们对应的是同一时刻。

Python 2与Python 3中datetime时区处理差异：timezone时间转换

1. Python 2.7环境

Python 2.7的datetime包中未内置timezone类，需借助第三方库解决。

pip install pytz
import pytz  
from datetime import datetime
 
u = datetime.utcnow()
u = u.replace(tzinfo=pytz.utc) #NOTE: it works only with a fixed utc offset
 
print(u)   # prints UTC time
>>> '2020-10-23 06:33:19+00:00'
print(u.astimezone(pytz.timezone("America/New_York")))     # prints another timezone
>>> '2020-10-23 02:33:19-04:00'
 
t = datetime.now(tz=pytz.timezone('Asia/Shanghai')
print(t)
>>> '2020-10-23 14:33:19+08:00'
print(t.astimezone(pytz.timezone("America/New_York")))
>>> '2020-10-23 02:33:19-04:00'
 
t = datetime.now()
print(t)
>>> '2020-10-23 14:33:19'
print(t.astimezone(pytz.timezone("America/New_York")))
>>> ValueError: astimezone() cannot be applied to a naive datetime

datetime.replace(tzinfo=tz) 将timezone信息赋给datetime对象，不改变日期值，使datetime从无时区状态变为有时区状态。
datetime.astimezone(tzinfo=tz) 执行时区转换，将datetime转换为新时区的值。执行此方法的datetime必须已声明timezone，否则会报错cannot apply to a naive datetime。

2. Python 3环境

Python 3.2之后的datetime包引入了timezone类。

from datetime import datetime, timedelta, timezone
 
u = datetime.utcnow()
u = u.replace(tzinfo=timezone.utc) #NOTE: it works only with a fixed utc offset
 
print(u)   # prints UTC time
>>> '2020-10-23 06:33:19+00:00'
print(u.astimezone(timezone(timedelta(hours=-4), "America/New_York")))    # prints another timezone
>>> '2020-10-23 02:33:19-04:00'