mirror of
https://github.com/wangwangit/SubsTracker.git
synced 2026-11-19 15:38:18 +08:00
修复 #91 / #52 / #166 类时区相关问题的根因:旧 getCurrentTimeInTimezone 只返回 new Date(),被调用方误以为是"用户本地时间对象"。 变化点: - 新增 getNowInTimezone(tz, now?) 返回 {utc, parts, hourString, isoLocal} 强制业务代码显式选择需要 UTC 时刻还是用户 TZ 字段 - 新增 getTimezoneHourString(date, tz) 调度器通知时段判断专用 - 新增 getDaysBetween(from, to, tz) 基于用户 TZ 各自零点的整天数差, 修复"凌晨 0–8 点创建订阅默认日期变前一天"的 #166 - formatLocalDate 替代 formatTimeInTimezone(保留旧名作 alias) - 旧 API(getCurrentTimeInTimezone / convertUTCToTimezone)保留为兼容 wrapper,加显眼注释说明其语义陷阱 - 全文 JSDoc 标注 + 中文用途说明,启用 // @ts-check - 40 条单测覆盖:UTC/北京/纽约 DST、跨日界、#166 边界、非法时区兜底 附带:/debug 页新增"时区诊断"区块,直观展示 UTC vs 用户 TZ 当前小时、 通知时段是否命中——这是用户自助排查"为什么没收到通知"的入口 Refs Task 2 of refactor/v3-product-grade plan.