Swift中DateFormatter格式化日期返回前一天的解决方法

DevOps 小满

2026-8-28

问题根因

次日计算逻辑有缺陷：直接通过addingTimeInterval(24 * 3600)累加秒数算次日，无法兼容夏令时切换、闰秒、时区调整等场景，计算出的时间点本身就可能和预期的日期节点存在偏差。
时区配置和业务预期不匹配：硬编码TimeZone(secondsFromGMT: 10800)即GMT+3固定偏移，既不对齐打印Date时默认使用的UTC时区，也不对齐用户本地时区，很容易出现跨天偏差；而且固定秒数偏移无法自动适配夏令时变动，长期使用必然出现时间错误。
日历、本地化配置存在隐患：使用.current日历和Locale.autoupdatingCurrent，当用户设备使用非公历日历（比如佛历、伊斯兰历）、区域日期规则特殊时，会出现日期组件错位、数值偏差。
固定格式场景未使用标准locale：自定义dateFormat输出固定格式字符串时，必须使用en_US_POSIX标识的locale，否则系统会根据用户的区域设置（比如12/24小时制、日期排序规则）重写格式规则，导致输出的日月年错位。

修复步骤

替换次日计算逻辑，使用系统Calendar API处理日期增减，自动规避时间偏移问题：

// 初始化公历日历，避免非公历日历导致的计算错误
let calendar = Calendar(identifier: .gregorian)
// 根据业务需求设置时区：要本地日期用.current，要UTC日期用TimeZone(secondsFromGMT: 0)
calendar.timeZone = .current
// 替换原有累加24小时的逻辑，自动处理夏令时、闰秒等特殊场景
guard let nextDayShouldBe = calendar.date(byAdding: .day, value: 1, to: currentDay) else {
    // 处理异常
    return
}

修正Date格式化扩展的配置，移除不可靠的硬编码参数：

extension Date {
   func getFormattedDate(format: String, timeZone: TimeZone = .current) -> String {
        let dateFormatter = DateFormatter()
        // 固定使用公历日历
        dateFormatter.calendar = Calendar(identifier: .gregorian)
        // 固定POSIX标准locale，避免区域设置篡改格式规则
        dateFormatter.locale = Locale(identifier: "en_US_POSIX")
        dateFormatter.dateFormat = format
        // 业务侧传入对应时区，不硬编码固定偏移
        dateFormatter.timeZone = timeZone
        return dateFormatter.string(from: self)
    }
}

调用说明

如果需要和print(Date())输出的UTC时间日期对齐（比如你日志中打印的2022-07-02 21:58:11 +0000对应的7月2日），调用时传入UTC时区即可：

// 输出UTC时区下的日期字符串，结果为2022-07-02
let nextDayStr = nextDayShouldBe.getFormattedDate(
    format: "yyyy-MM-dd",
    timeZone: TimeZone(secondsFromGMT: 0)
)

如果需要展示用户本地时区对应的日期，直接调用不传timeZone参数即可，默认使用当前系统时区。
如果业务要求固定使用某一时区，优先通过时区标识初始化（比如TimeZone(identifier: "Europe/Moscow")），不要硬编码秒数偏移，系统会自动处理该时区的夏令时调整，比固定偏移可靠。

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