iOS端DateFormatter格式化时间戳时返回错误年份问题排查

问题原因分析 #

你的代码出现偶发年份异常，核心原因有两个：

• 设备日历类型非公历：DateFormatter默认采用用户设备设置的日历系统。比如泰国常用的佛历（Buddhist）比公历多543年，2024+543=2567，正好匹配你遇到的异常值；0006这类年份则可能来自埃塞俄比亚日历等小众历法，这类日历的年份计算逻辑与公历差异极大。
• 未遵循ISO 8601格式化的最佳实践：未固定Locale和Calendar，导致设备地区/日历设置变化时，格式化规则被篡改，进而出现异常。

你的代码问题 #

当前代码没有指定calendar和locale，完全依赖系统默认值，当用户设备切换到非公历日历或特殊地区设置时，就会出现年份格式错误。

解决方案 #

要确保年份始终正确，需对DateFormatter做以下强制配置：

• 强制使用公历：明确指定Calendar为公历，不受用户设备日历设置影响。
• 固定Locale为en_US_POSIX：这是ISO 8601格式处理的标准做法，避免地区设置导致的格式解析/生成偏差。
• 保证线程安全：如果需要复用DateFormatter，不要在多线程间共享实例——要么每次使用时创建新实例（上报场景性能影响可忽略），要么用线程本地存储（Thread.current.threadDictionary）维护每个线程的独立实例。

修正后的代码 #

let dateFormatter = DateFormatter()
// 固定Locale，避免地区差异影响ISO格式
dateFormatter.locale = Locale(identifier: "en_US_POSIX")
// 强制使用公历，不受设备日历设置影响
dateFormatter.calendar = Calendar(identifier: .gregorian)
dateFormatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSXXX"
let currentDate = Date()
let formattedDate = dateFormatter.string(from: currentDate)

验证方法 #

你可以手动切换设备的日历设置（设置→通用→语言与地区→日历）为佛历，测试原代码是否生成2567，修正后的代码是否始终输出公历年份。

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