跨天UTC时间戳计算日期错位问题排查与优化咨询

我编写了一个Python函数，接收指定日期、纬度和经度参数，预期返回3个UTC时间戳：

• 当日下午的时间戳
• 当日深夜的时间戳
• 次日日出前不久的时间戳

但由于跨天计算逻辑问题，结果完全不符合预期，想知道哪里出错了，有没有更优实现方案？

附原函数代码：

import datetime as dt
from suntime import Sun

def key_timestamps(date, latitude, longitude):  
    date = dt.datetime.strptime(date, "%Y-%m-%d")
    
    sun = Sun(latitude, longitude)
    
    sunrise = sun.get_sunrise_time(date)
    sunset = sun.get_sunset_time(date)
    
    next_day = date + dt.timedelta(days=1)
    sunrise_next_day = sun.get_sunrise_time(next_day)
    
    solar_noon = sunrise + (sunset - sunrise) / 2
    peak_heating = solar_noon + dt.timedelta(hours=2, minutes=30)
    evening_release = sunset + dt.timedelta(hours=3)
    morning_minimum = sunrise_next_day - dt.timedelta(hours=1)
    
    return [
          int(peak_heating.timestamp()), 
          int(evening_release.timestamp()),
          int(morning_minimum.timestamp())
          ] 

singapore_results = key_timestamps("2022-05-29", 1.3521, 103.8198)
print(singapore_results)

错误输出示例 #

新加坡案例输出：[1653809526, 1653746868, 1653947784]，转换为UTC时间后：

• 2022年5月29日星期日7:32:06 AM（可能正确）
• 2022年5月28日星期六2:07:48 PM（应为第一个时间之后数小时，完全错误）
• 2022年5月30日星期一9:56:24 PM（同样错误）

洛杉矶案例：

la_results = key_timestamps("2022-05-29", 34.0549, 118.2426)

输出：[1653806070, 1653747048, 1653940656]，转换为UTC时间后：

• 2022年5月29日星期日6:34:30 AM（错误）
• 2022年5月28日星期六2:10:48 PM（错误）
• 2022年5月30日星期一7:57:36 PM（错误）

错误原因 #

核心问题是时区处理混乱：

1. suntime库的get_sunrise_time()和get_sunset_time()返回的是本地时区的datetime对象，但直接调用timestamp()时，Python会将其转换为UTC时间戳，导致时间偏移。
2. 传入的date是不带时区的本地datetime，后续时间加减操作未统一时区，跨天计算时出现日期错位。

修正方案 #

方法1：统一使用UTC时区处理（兼容Python 3.6+） #

将所有时间转换为UTC时区后再计算，彻底避免时区偏移问题：

import datetime as dt
from suntime import Sun
import pytz

def key_timestamps(date_str, latitude, longitude):
    # 解析日期为UTC时区的datetime
    date_utc = dt.datetime.strptime(date_str, "%Y-%m-%d").replace(tzinfo=pytz.UTC)
    # 获取目标地点的本地时区
    sun_obj = Sun(latitude, longitude)
    local_tz = pytz.timezone(sun_obj.get_local_timezone())
    
    # 转换为本地日期，用于日出日落计算
    date_local = date_utc.astimezone(local_tz).date()
    
    # 获取本地时区的日出日落，再转换为UTC
    sunrise_local = sun_obj.get_sunrise_time(date_local)
    sunrise_utc = sunrise_local.astimezone(pytz.UTC)
    
    sunset_local = sun_obj.get_sunset_time(date_local)
    sunset_utc = sunset_local.astimezone(pytz.UTC)
    
    # 计算次日本地日期的日出，转UTC
    next_day_local = date_local + dt.timedelta(days=1)
    sunrise_next_local = sun_obj.get_sunrise_time(next_day_local)
    sunrise_next_utc = sunrise_next_local.astimezone(pytz.UTC)
    
    # 基于UTC时间计算目标时间点
    solar_noon_utc = sunrise_utc + (sunset_utc - sunrise_utc) / 2
    peak_heating_utc = solar_noon_utc + dt.timedelta(hours=2, minutes=30)
    evening_release_utc = sunset_utc + dt.timedelta(hours=3)
    morning_minimum_utc = sunrise_next_utc - dt.timedelta(hours=1)
    
    return [
        int(peak_heating_utc.timestamp()),
        int(evening_release_utc.timestamp()),
        int(morning_minimum_utc.timestamp())
    ]

# 测试新加坡案例
singapore_results = key_timestamps("2022-05-29", 1.3521, 103.8198)
print("新加坡UTC时间戳:", singapore_results)
# 转换为UTC时间查看
for ts in singapore_results:
    print(dt.datetime.fromtimestamp(ts, pytz.UTC))

方法2：使用zoneinfo（Python 3.9+，标准库） #

如果使用Python 3.9及以上版本，可直接用标准库zoneinfo简化时区处理：

import datetime as dt
from suntime import Sun
from zoneinfo import ZoneInfo

def key_timestamps(date_str, latitude, longitude):
    date_utc = dt.datetime.strptime(date_str, "%Y-%m-%d").replace(tzinfo=ZoneInfo("UTC"))
    sun_obj = Sun(latitude, longitude)
    local_tz = ZoneInfo(sun_obj.get_local_timezone())
    
    date_local = date_utc.astimezone(local_tz).date()
    
    sunrise_local = sun_obj.get_sunrise_time(date_local)
    sunrise_utc = sunrise_local.astimezone(ZoneInfo("UTC"))
    
    sunset_local = sun_obj.get_sunset_time(date_local)
    sunset_utc = sunset_local.astimezone(ZoneInfo("UTC"))
    
    next_day_local = date_local + dt.timedelta(days=1)
    sunrise_next_local = sun_obj.get_sunrise_time(next_day_local)
    sunrise_next_utc = sunrise_next_local.astimezone(ZoneInfo("UTC"))
    
    solar_noon_utc = sunrise_utc + (sunset_utc - sunrise_utc) / 2
    peak_heating_utc = solar_noon_utc + dt.timedelta(hours=2, minutes=30)
    evening_release_utc = sunset_utc + dt.timedelta(hours=3)
    morning_minimum_utc = sunrise_next_utc - dt.timedelta(hours=1)
    
    return [
        int(peak_heating_utc.timestamp()),
        int(evening_release_utc.timestamp()),
        int(morning_minimum_utc.timestamp())
    ]

关键改进点 #

• 明确区分本地时区与UTC时区，所有计算要么统一在本地时区完成后转UTC，要么全程基于UTC处理。
• 使用astimezone()正确转换时区，避免裸datetime对象的隐式时区转换错误。
• 确保date参数对应的本地日期正确，解决跨天时的日期错位问题。

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