pandas与datetime时区感知时间差计算不一致问题排查与解决

问题重现 #

from zoneinfo import ZoneInfo
import datetime
import pandas as pd

utc = ZoneInfo(key='UTC')

d1 = datetime.datetime(2023, 3, 1, 0, 0, tzinfo=ZoneInfo(key='Europe/Paris'))
d2 = datetime.datetime(2023, 9, 1, 0, 0, tzinfo=ZoneInfo(key='Europe/Paris'))

p1 = pd.Timestamp(d1)
p2 = pd.Timestamp(d2)

# datetime模块中，原时区与UTC转换后的时间差不相等，输出True
print(d2 - d1 != d2.astimezone(utc) - d1.astimezone(utc))
# Pandas中两者相等，输出False
print(p2 - p1 != p2.astimezone(utc) - p1.astimezone(utc))
# 测试断言失败，输出False
print(d2 - d1 == p2 - p1)

问题核心：Europe/Paris时区在2023年3-9月包含夏令时切换，datetime直接计算本地时间差时忽略夏令时导致的实际UTC时长差异；而Pandas默认先将时区时间转换为UTC再计算差值，因此两者结果不一致，导致测试失败。

解决办法 #

要让测试通过，可从两个方向调整逻辑：

1. 调整datetime计算逻辑，对齐Pandas行为

将datetime对象先转换为UTC再计算差值，确保和Pandas的计算逻辑一致：

# 统一使用UTC时间计算差值
dt_diff = d2.astimezone(utc) - d1.astimezone(utc)
pd_diff = p2 - p1
print(dt_diff == pd_diff)  # 输出True，测试通过

2. 调整Pandas计算逻辑，对齐datetime行为

Pandas没有全局开关直接禁用UTC转换，但可以手动模拟datetime的本地时间差计算：移除时区信息后计算naive时间的差值：

# 基于本地时间数值计算差值（忽略时区规则）
pd_diff_local = pd.Timestamp(p2.tz_localize(None)) - pd.Timestamp(p1.tz_localize(None))
dt_diff = d2 - d1
print(pd_diff_local == dt_diff)  # 输出True，测试通过

⚠ 注意：这种方式仅适用于明确需要忽略夏令时等时区规则的场景，业务中不推荐，会丢失时间准确性。

Pandas与datetime的时间差计算差异 #

• datetime模块：计算时区感知datetime的差值时，直接对本地时间的数值做减法，不考虑时区规则（如夏令时切换）带来的实际物理时长变化。示例中，本地时间差是6个月整（184天），但实际UTC时长因夏令时少1小时，因此转换UTC后的差值是183天23小时。
• Pandas：对于时区感知的Timestamp，计算差值时先转换为UTC时间戳（基于Unix绝对时间）再做减法，结果反映实际物理时间差，不受本地时区规则影响，因此原时区与UTC转换后的差值相等。

内容的提问来源于stack exchange，提问作者scūriolus