Swift中DateFormatter转换日期字符串输出时间错误问题

问题背景 #

需要将API返回的PHT时区日期字符串转换为UI端指定展示格式，具体规则如下：

• API返回日期格式：MM/dd/yyyy HH:mma，示例值：06/28/2022 06:55PM
• UI目标展示格式：dd MMM yyyy, hh:mm a，预期输出：28 Jun 2022, 06:55 PM

原有实现运行后实际输出为28 Jun 2022, 12:55 PM，手动调整locale、timeZone属性后问题仍未解决。

问题根因 #

核心问题是解析阶段的DateFormatter格式符与实际时间格式不匹配：
HH是24小时制的小时占位符，但API返回的时间是搭配AM/PM标识的12小时制值，格式符错配直接导致小时字段解析逻辑混乱，最终输出错误时间。此外如果不手动固定解析、格式化阶段的locale和时区，设备默认的区域、时区设置还可能引发月份缩写显示异常、AM/PM标识解析失败、时间偏移等衍生问题。

修复后可运行代码 #

extension Date {
    func toString(format: String, timeZone: TimeZone = .current, locale: Locale = Locale(identifier: "en_US_POSIX")) -> String {
        let formatter = DateFormatter()
        formatter.dateFormat = format
        formatter.timeZone = timeZone
        formatter.locale = locale
        return formatter.string(from: self)
    }
    
    init?(from phtDateStr: String) {
        let formatter = DateFormatter()
        // 核心修复：12小时制时间搭配AM/PM时，小时位用hh而非HH
        formatter.dateFormat = "MM/dd/yyyy hh:mma"
        // 固定locale避免设备区域设置影响格式解析
        formatter.locale = Locale(identifier: "en_US_POSIX")
        // 指定解析时区为PHT（菲律宾时间，对应Asia/Manila，UTC+8）
        formatter.timeZone = TimeZone(identifier: "Asia/Manila")!
        guard let date = formatter.date(from: phtDateStr) else { return nil }
        self = date
    }
}

// 测试逻辑
let targetDisplayFormat = "dd MMM yyyy, hh:mm a"
let apiResponseDateStr = "06/28/2022 06:55PM"
if let convertedDate = Date(from: apiResponseDateStr) {
    let displayStr = convertedDate.toString(
        format: targetDisplayFormat,
        timeZone: TimeZone(identifier: "Asia/Manila")!
    )
    print(displayStr) // 控制台输出：28 Jun 2022, 06:55 PM
}

关键修复点说明 #

• 将解析阶段的小时格式符从HH（24小时制）替换为hh（12小时制），与API返回的带AM/PM标识的时间格式完全匹配，从根源解决小时解析错误问题
• 解析、格式化阶段统一固定locale为en_US_POSIX，这是苹果官方推荐的解析固定格式服务端返回时间的配置，可避免不同设备区域设置导致的格式兼容问题
• 明确指定解析和格式化使用的时区为PHT对应的Asia/Manila时区，避免默认跟随设备时区导致的时间偏移问题

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