使用pytz时区计算当日起始时间出现偏差的问题排查

问题背景 #

我们需要通过年、月、日输入字段计算日期，例如year_sent=2021、month_sent=0、date_sent=31对应2021年1月31日。使用以下pytz相关代码计算当日起始时间戳：

tz = pytz.timezone(obj_timezone)    
timestamp_current_tz_start_of_day   = datetime(year_sent, month_sent, date_sent, 0, 0, tzinfo=tz)

timestamp_current_start_of_day      = int((timestamp_current_tz_start_of_day - datetime(1970, 1, 1,0,0, tzinfo=pytz.utc)).total_seconds() * 1000)

预期得到对应时区2021年1月31日00:00的时间戳，但实际结果为该时区2021年1月31日00:53的时间戳，问题出在哪里？

问题原因 #

直接在datetime构造函数中传入pytz时区对象作为tzinfo参数是错误用法。pytz的时区对象包含该时区的历史偏移规则（比如早期的本地平均时间LMT），直接通过datetime(..., tzinfo=tz)创建带时区的datetime时，会应用该时区最原始的偏移值，而非当前生效的标准时区偏移，这就导致了你看到的53分钟时间误差。

解决方案 #

正确做法是使用pytz时区对象的localize()方法，为无时区信息的datetime对象添加正确的时区规则：

from datetime import datetime
import pytz

tz = pytz.timezone(obj_timezone)
# 注意：datetime的月份参数范围是1-12，需将输入的month_sent=0转为1
naive_datetime = datetime(year_sent, month_sent + 1, date_sent, 0, 0)
# 用localize绑定时区，is_dst=None会自动检测夏令时，避免歧义
timestamp_current_tz_start_of_day = tz.localize(naive_datetime, is_dst=None)

# 计算UTC时间戳
timestamp_current_start_of_day = int((timestamp_current_tz_start_of_day - pytz.utc.localize(datetime(1970, 1, 1))).total_seconds() * 1000)

额外注意：Python的datetime构造函数中月份参数要求是1-12，你的代码中month_sent=0属于不规范写法（Python会自动溢出处理为1月），建议显式转换为合法月份值，避免潜在问题。

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