萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> iOS 開發

iOS 日期時間格式轉換完全指南:NSDateFormatter 深度解析

核心類:NSDateFormatter

iOS 日期格式化核心類,支援「日期 → 字串」與「字串 → 日期」雙向轉換。執行緒不安全,頻繁使用建議快取或每次新建。

基礎用法:當前時間格式化輸出


// 1. 建立格式化器
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];

// 2. 設定日期格式(Unicode Technical Standard #35)
[formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];

// 3. 取得當前時間
NSDate *now = [NSDate date];

// 4. 日期 → 字串
NSString *dateString = [formatter stringFromDate:now];
// 結果:2024-01-15 14:30:45

NSLog(@"%@", dateString);

// 5. 釋放(MRC 環境)
[formatter release];

常用格式符號完整對照表

符號意義範例輸出
y / yyyy年2024 / 24
M / MM / MMM / MMMM月(數字/縮寫/全名)1 / 01 / Jan / January
d / dd日5 / 05
E / EEE / EEEE星期(縮寫/全名)Mon / Monday
aAM/PMAM / PM
h / hh12 小時制時2 / 02
H / HH24 小時制時14 / 14
m / mm分5 / 05
s / ss秒9 / 09
S / SS / SSS毫秒5 / 05 / 005
z / zzzz時區名稱GMT+08:00 / China Standard Time
Z / ZZZZZ時區偏移+0800 / +08:00

常見格式預設範本


// ISO 8601 標準(API 交換首選)
@"yyyy-MM-dd'T'HH:mm:ssZZZZZ"  // 2024-01-15T14:30:45+08:00
@"yyyy-MM-dd'T'HH:mm:ss.SSSZ"  // 含毫秒

// 純日期
@"yyyy-MM-dd"                  // 2024-01-15
@"yyyy年MM月dd日"              // 2024年01月15日

// 純時間
@"HH:mm:ss"                    // 14:30:45
@"hh:mm a"                     // 02:30 PM

// 中文常用
@"M月d日 HH:mm"                // 1月15日 14:30
@"yyyy/M/d EEEE"               // 2024/1/15 星期一

// 檔案命名安全格式
@"yyyyMMdd_HHmmss"             // 20240115_143045

進階:時間戳 轉 字串 封裝方法


+ (NSString *)dateStringFromTimestamp:(NSTimeInterval)timestamp 
                            format:(NSString *)formatString {
    NSDate *date = [NSDate dateWithTimeIntervalSince1970:timestamp];
    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
    [formatter setDateFormat:formatString];
    // 建議設定 locale 避免 24/12 小時制歧義
    [formatter setLocale:[NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"]];
    NSString *str = [formatter stringFromDate:date];
    return str;
}

// 使用
NSTimeInterval ts = [[NSDate date] timeIntervalSince1970]; // 當前時間戳
NSString *str = [self dateStringFromTimestamp:ts format:@"yyyy-MM-dd HH:mm:ss"];

反向解析:字串 → 日期


NSDateFormatter *parser = [[NSDateFormatter alloc] init];
[parser setDateFormat:@"yyyy-MM-dd HH:mm:ss"];
[parser setLocale:[NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"]];

NSString *input = @"2024-01-15 14:30:45";
NSDate *date = [parser dateFromString:input];
if (date) {
    NSLog(@"解析成功: %@", date);
} else {
    NSLog(@"格式不符,無法解析");
}

效能優化:快取 Formatter(關鍵)

NSDateFormatter 建立開銷大,高頻呼叫必須快取:


// 單例快取管理器
@interface DateFormatterCache : NSObject
+ (NSDateFormatter *)formatterWithFormat:(NSString *)format;
@end

@implementation DateFormatterCache
+ (NSDateFormatter *)formatterWithFormat:(NSString *)format {
    static NSMutableDictionary *cache;
    static dispatch_once_t once;
    dispatch_once(&once, ^{ cache = [NSMutableDictionary dictionary]; });
    
    NSDateFormatter *formatter = cache[format];
    if (!formatter) {
        formatter = [[NSDateFormatter alloc] init];
        formatter.dateFormat = format;
        formatter.locale = [NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"];
        formatter.timeZone = [NSTimeZone systemTimeZone];
        cache[format] = formatter;
    }
    return formatter;
}
@end

// 使用
NSDateFormatter *fmt = [DateFormatterCache formatterWithFormat:@"yyyy-MM-dd"];
NSString *str = [fmt stringFromDate:[NSDate date]];

時區與 Locale 陷阱

❌ 未設定 locale 導致 12/24 小時制錯誤
用戶地區設定影響解析,固定用 `en_US_POSIX`**
❌ 未設定 timeZone 導致跨時區顯示錯誤
預設系統時區,伺服器時間通常為 UTC,需明確設定:
`formatter.timeZone = [NSTimeZone timeZoneWithAbbreviation:@"UTC"];`
❌ 重複建立 Formatter 導致滾動卡頓
列表渲染大量日期時必須快取

Swift 5+ 現代化寫法


let formatter = DateFormatter()
formatter.dateFormat = "yyyy-MM-dd HH:mm:ss"
formatter.locale = Locale(identifier: "en_US_POSIX")
formatter.timeZone = TimeZone(secondsFromGMT: 0)

let now = Date()
let string = formatter.string(from: now)  // 日期 -> 字串

if let date = formatter.date(from: "2024-01-15 14:30:45") { // 字串 -> 日期
    print(date)
}

// ISO8601 專用解析器(iOS 10+)
let isoFormatter = ISO8601DateFormatter()
isoFormatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
let isoString = isoFormatter.string(from: Date())
copyright © 萬盛學電腦網 all rights reserved