DateFormatter使用HH格式偶尔出现AM标识的异常修复咨询

这两个异常其实都指向同一个核心问题——DateFormatter不是线程安全的，再加上格式字符串的小失误，才导致了这些偶发的奇怪输出。我来一步步拆解和修复：

问题1：HH:mm:ss格式出现多余的AM #

HH是24小时制的小时格式，理论上绝对不会输出AM/PM标记，但偶发出现的原因是：

• 你在多线程环境下共享了同一个DateFormatter实例，当多个线程同时调用它的格式化方法时，会打乱其内部的状态（比如某个线程可能无意间修改了locale、dateFormat等属性），导致格式混合错乱，出现24小时制时间加12小时制标记的矛盾输出。

修复建议：

• 确保每个线程使用独立的DateFormatter实例；
• 若要共享实例，必须用线程锁（比如DispatchQueue.sync）保护对它的所有访问；
• iOS 10+/macOS 10.12+可以考虑用ISO8601DateFormatter替代，它的线程安全性更好，也更适合处理标准时间格式。

问题2：全球应用中偶发带AM的异常时间戳 #

你的代码里存在两个问题：

1. 线程安全隐患：Sample类的formatter是实例变量，且从private init来看应该是单例，多线程调用timestamp()时共享同一个实例，同样会导致内部状态错乱，出现AM标记；
2. 格式字符串错误：你用了ZZZZZ作为时区格式，它会输出时区偏移（比如UTC会输出+00:00），但你预期的是结尾的Z（ISO标准的UTC标记），这里应该用单引号包裹Z来硬编码输出，避免DateFormatter解析为时区偏移。

修复后的代码示例 #

这里提供两种线程安全的实现方式：

方式1：用串行队列保护共享实例（性能更优）

public class Sample {
    // 创建专用串行队列保证线程安全
    private let formatterQueue = DispatchQueue(label: "com.your.app.dateformatter.queue")
    private var formatter: DateFormatter?
    
    private init() {}
    
    public func timestamp() -> String {
        return formatterQueue.sync {
            if let existingFormatter = self.formatter {
                return existingFormatter.string(from: Date())
            }
            // 首次初始化时配置格式
            let newFormatter = DateFormatter()
            newFormatter.timeZone = TimeZone(secondsFromGMT: 0)
            // 修正时区格式为硬编码的'Z'，保证UTC时输出Z
            newFormatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.AAAAAAA'Z'"
            self.formatter = newFormatter
            return newFormatter.string(from: Date())
        }
    }
    
    // 单例实现
    public static let shared = Sample()
}

方式2：每次调用创建新实例（实现更简单）

如果你的timestamp调用频率不是极高，创建DateFormatter的性能开销完全可以忽略，这种方式最省心：

public class Sample {
    private init() {}
    
    public func timestamp() -> String {
        let formatter = DateFormatter()
        formatter.timeZone = TimeZone(secondsFromGMT: 0)
        formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.AAAAAAA'Z'"
        return formatter.string(from: Date())
    }
    
    public static let shared = Sample()
}

关键总结 #

• 永远记住DateFormatter不是线程安全的，多线程场景下必须避免共享实例，或用锁/队列保护；
• 当需要输出固定字符（比如UTC的Z）时，一定要用单引号包裹，防止DateFormatter将其解析为格式占位符；
• 偶发的格式异常几乎都是线程安全问题导致的，因为单线程下DateFormatter的行为是稳定的。

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