Core Data使用Calendar.current.startOfDay导致时区日期错误如何修复

问题描述 #

此前错误使用Calendar.current.startOfDay(for: Date())填充Core Data的日期属性，导致用户跨时区时，日期属性字段会被存储为不同值，示例如下：

• Timezone 1 - 25th 23:00
• Timezone 2 - 25th 22:00
• Timezone 3 - 26th 05:00

最初计划将Calendar改为使用UTC时区并执行数据迁移，期望所有条目统一对齐到用户视角的当日零点：

期望结果：

• Timezone 1 - 26th 00:00
• Timezone 2 - 26th 00:00
• Timezone 3 - 26th 00:00

但直接对现有日期执行UTC时区的startOfDay计算会出现偏差：时区1的条目会得到25th 00:00而非预期的26th 0:00，无法精准更新现有条目。

原有设计诉求 #

之前使用startOfDay存储日期是为了简化查询逻辑：任意时间获取当日startOfDay即可返回当日全量条目；查询历史日期同理，用户回退2天时，通过Calendar.current.date(byAdding: .day, value: -2, to: date)计算对应日期的startOfDay即可完成查询，现在时区问题完全破坏了上述逻辑。

曾评估过两种替代方案：

1. 遍历所有条目计算其原本对应的日期，将日期属性改为字符串格式（例如26-05-2021）存储
2. 拆分存储日、月、年三个独立字段再对应查询

后续排除了UTC日历方案：该方案会导致用户视角的日期出错，比如用户当地已到次日但UTC仍在前一天时，查询逻辑会不符合用户预期。

最终落地执行步骤 #

你提出的「拆分存储年月日、按当前设备日历查询」的方案是该场景下的最优解，具体执行步骤如下：

1. Core Data模型升级 #

• 新增三个Integer类型的非可选存储属性：day、month、year，可设置默认值为0
• 原有日期属性保留作为备份，迁移验证完成后可按需选择是否删除

2. 存量数据迁移 #

• 新增迁移完成标记位（存储在UserDefaults中），App启动时判断如果未完成迁移则执行迁移逻辑
• 遍历Core Data中所有现存的条目，对每条存储的旧日期，用Calendar.current.dateComponents([.day, .month, .year], from: date)提取对应用户本地时区的年月日，写入新增的三个属性中
• 批量保存Core Data上下文，完成后标记迁移状态为已完成，避免重复执行

3. 新数据写入逻辑调整 #

• 后续新增条目时，直接用当前Calendar.current提取当前日期的年月日写入对应字段，不再依赖startOfDay的Date值作为查询依据
• 原有Date类型属性可继续存储完整时间戳，满足其他时间相关的展示、排序需求

4. 查询逻辑适配 #

• 每次查询指定日期的条目时，先通过Calendar.current提取目标日期的年月日，直接匹配三个字段的数值即可返回对应日期的全量数据
• 历史日期查询逻辑只需将原来的date(byAdding)计算结果提取年月日即可，无需改动上层交互逻辑

副作用说明 #

你提到的「用户在当地27号添加数据后切换时区，可能看到26号的数据」属于时区场景下的合理取舍，符合普通用户对「本地时间创建的条目归属于本地日期」的直觉认知，没有强制规避的必要，该方案对旧数据的兼容性也完全符合预期。

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