Python 2.x中UNIX毫秒时间戳与Datetime转换时差问题

我懂你碰到的这个问题——这十有八九是本地时区的夏令时（DST）或者时区偏移处理不一致搞出来的锅。Python 2.x的datetime模块在时区转换这块确实容易踩坑，尤其是没明确指定时区、依赖系统本地时区自动识别的时候，很容易出现这种1小时的偏差。

先给你复现一下这个问题的纯Python代码（完全不用fastavro也能重现）：

import datetime
import time

# 原始毫秒时间戳
timestamp_ms = 1459952824358

# 转本地datetime
dt_local = datetime.datetime.fromtimestamp(timestamp_ms / 1000.0)
print("转换后的本地Datetime:", dt_local)  # 输出：2016-04-06 09:27:04.358000

# Python 2.x反向转换回毫秒时间戳的常用方式
back_to_ms = int(time.mktime(dt_local.timetuple()) * 1000 + dt_local.microsecond / 1000)
print("反向转换后的毫秒时间戳:", back_to_ms)
print("偏差值:", back_to_ms - timestamp_ms)  # 会输出3600000，也就是整整1小时

问题根源分析 #

问题出在time.mktime()和datetime.fromtimestamp()对时区的处理逻辑差异上：

• datetime.fromtimestamp(timestamp_sec)会把UTC时间戳转换为本地时区的datetime，并且会自动识别目标时间点是否处于夏令时，应用对应的时区偏移；
• 而time.mktime(dt.timetuple())是把本地datetime转换为UTC时间戳，但如果你的datetime对象没有携带明确的时区信息，它会基于当前系统的时区设置来计算偏移——如果当前系统的夏令时状态和目标时间点（2016年4月6日）的夏令时状态不一致，或者计算偏移时没有正确识别目标时间的DST状态，就会出现1小时的偏差。

2016年4月6日在很多实行夏令时的地区（比如欧洲中部时间、英国夏令时等）已经进入夏令时，本地时区的偏移比标准时间多1小时，这就是偏差的核心原因。

解决方案 #

这里给你三个可行的解决办法，按推荐程度排序：

1. 全程使用UTC时区（最稳妥，推荐）

如果业务场景允许，尽量用UTC时间戳和UTC datetime互转，彻底避开本地时区和夏令时的干扰：

import datetime

timestamp_ms = 1459952824358

# 转UTC datetime
dt_utc = datetime.datetime.utcfromtimestamp(timestamp_ms / 1000.0)
print("UTC Datetime:", dt_utc)  # 输出：2016-04-06 08:27:04.358000

# 反向转换回毫秒时间戳（Python 2.x兼容写法）
epoch = datetime.datetime.utcfromtimestamp(0)
delta = dt_utc - epoch
back_to_ms = int(delta.total_seconds() * 1000)
print("反向转换后的毫秒时间戳:", back_to_ms)  # 输出：1459952824358，和原始值完全一致

2. 用pytz为datetime附加明确时区信息

Python 2.x的datetime没有原生时区支持，你可以用pytz库来给datetime对象标记时区，确保转换前后的偏移计算一致：

import datetime
import pytz

timestamp_ms = 1459952824358
# 替换成你的实际本地时区，比如'Europe/London'、'Asia/Shanghai'等
local_tz = pytz.timezone('Europe/London')

# 转带时区的本地datetime
dt_naive = datetime.datetime.fromtimestamp(timestamp_ms / 1000.0)
# is_dst=None会强制检查目标时间的夏令时状态，避免错误偏移
dt_local = local_tz.localize(dt_naive, is_dst=None)
print("带时区的本地Datetime:", dt_local)

# 反向转换回毫秒时间戳
dt_utc = dt_local.astimezone(pytz.utc)
epoch = datetime.datetime.utcfromtimestamp(0).replace(tzinfo=pytz.utc)
delta = dt_utc - epoch
back_to_ms = int(delta.total_seconds() * 1000)
print("反向转换后的毫秒时间戳:", back_to_ms)  # 和原始值一致

3. 手动计算时区偏移（不推荐，易出错）

如果不想引入第三方库，可以手动计算目标时间点的时区偏移（包括夏令时），但这种方式需要自己处理DST判断，容易出问题：

import datetime
import time

timestamp_ms = 1459952824358
timestamp_sec = timestamp_ms / 1000.0

# 转本地datetime
dt_local = datetime.datetime.fromtimestamp(timestamp_sec)

# 计算目标时间点的本地时区偏移（秒）
# time.timezone是UTC到本地标准时间的偏移，负数表示本地在UTC东边
# time.altzone是UTC到本地夏令时的偏移
time_struct = time.localtime(timestamp_sec)
if time.daylight and time_struct.tm_isdst:
    offset_sec = -time.altzone
else:
    offset_sec = -time.timezone

# 反向转换：本地datetime转UTC时间戳再转毫秒
utc_timestamp_sec = time.mktime(dt_local.timetuple()) - offset_sec
back_to_ms = int(utc_timestamp_sec * 1000 + dt_local.microsecond / 1000)
print("反向转换后的毫秒时间戳:", back_to_ms)  # 和原始值一致

总结 #

本质上，这个1小时偏差就是夏令时导致的时区偏移计算不一致。最省心的方式是全程用UTC时间；如果必须用本地时间，一定要用pytz这类库明确管理时区信息，别依赖Python 2.x原生datetime的隐式时区处理。

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