跨时区签到如何算今天：用 UTC 区间处理 23 小时和 25 小时的一天

先确定「今天」是哪个时区的一天

签到事件适合按 UTC 时刻存储，日报则按业务指定的时区统计。比如一家公司规定以 Asia/Shanghai 为准，员工换到其他时区并不会改变公司日报的边界；如果规则是以门店所在地为准，就由门店配置时区，而不是临时取浏览器所在时区。

用日报日期在业务时区构造当天零点和次日零点，分别转成 UTC，再按半开区间 [开始, 结束) 查询：event_at_utc >= ? AND event_at_utc < ?。次日零点只会归到次日，不用猜最后一秒的精度。不要用 UTC 开始时刻加 24 小时替代结束时刻：有夏令时的地方，一天可能实际只有 23 小时，也可能有 25 小时。

可运行实验：两个 01:30 都应该计入

下面用合成数据验证洛杉矶 2024 年的春季跳时和秋季回拨，并对比同一天的上海边界。回拨日墙上时钟出现两次 01:30，fold 用来区分这两个时刻。测试先将它们各自转成 UTC，再比较时刻。

from datetime import date, datetime, time, timedelta, timezone
from zoneinfo import ZoneInfo


def utc_day_bounds(day: date, business_zone: ZoneInfo):
    next_day = day + timedelta(days=1)
    local_start = datetime.combine(day, time.min, business_zone)
    local_end = datetime.combine(next_day, time.min, business_zone)
    return local_start.astimezone(timezone.utc), local_end.astimezone(timezone.utc)


los_angeles = ZoneInfo("America/Los_Angeles")
shanghai = ZoneInfo("Asia/Shanghai")
spring_start, spring_end = utc_day_bounds(date(2024, 3, 10), los_angeles)
assert spring_end - spring_start == timedelta(hours=23)

fall_day = date(2024, 11, 3)
fall_start, fall_end = utc_day_bounds(fall_day, los_angeles)
assert fall_end - fall_start == timedelta(hours=25)
shanghai_start, shanghai_end = utc_day_bounds(fall_day, shanghai)
assert shanghai_end - shanghai_start == timedelta(hours=24)
assert shanghai_start != fall_start

wall_time = datetime.combine(fall_day, time(1, 30), los_angeles)
earlier = wall_time.replace(fold=0).astimezone(timezone.utc)
later = wall_time.replace(fold=1).astimezone(timezone.utc)
assert later - earlier == timedelta(hours=1)
assert earlier.astimezone(los_angeles).fold == 0
assert later.astimezone(los_angeles).fold == 1

events = [fall_start - timedelta(seconds=1), fall_start, earlier, later, fall_end]
selected = [instant for instant in events if fall_start <= instant < fall_end]
assert selected == [fall_start, earlier, later]
assert utc_day_bounds(fall_day + timedelta(days=1), los_angeles)[0] == fall_end
print("9 项断言通过")

接入签到系统时的三个检查

• 时间输入：优先接收带偏移的时间戳或 UTC 时间戳。裸的本地时间不能直接当作 UTC；遇到回拨歧义要有明确偏移，遇到春季不存在的本地时间则要按业务规则校验，不能只靠附加时区对象。
• 报表查询：先计算上下界，再用同一种时间类型做范围查询。不要在过滤条件里把每一行先格式化成日期字符串；是否需要复合索引，结合门店等过滤条件和查询计划验证。两个时刻都属于当天不代表同一员工应计两次，去重是另一层业务规则。
• 适用范围：示例使用的城市在示例日期的零点都是有效且唯一的。支持任意历史时区时，要另外验证零点跳变、日期被跳过等边界，并记录时区数据版本；不同运行环境也可能需要提供 tzdata。

参考：Python 官方文档《zoneinfo》中的时区和 fold 说明。受鸿蒙开发实践中心的员工签到案例启发，本例是独立的本地实验，未部署或测试该案例的云环境。AI 辅助起草，代码在本地用合成时间戳运行验证。