要把字串正確解析成 NSDate,你必須同時提供兩樣東西:格式字串與時區/地區設定。格式字串寫錯一個字元,解析就會靜默回傳 nil,這是新手最常踩的坑。
y 年份,不補前導零yy 兩位數年份(補零)yyy / yyyy 四位數年份M 月份數字,不補零(一月為 1)MM 補零數字(01)MMM 英文縮寫(Jan、Feb、Mar、Apr、May、Jun、Jul、Aug、Sep、Oct、Nov、Dec)MMMM 英文全名(January、February … December)d 日,不補零(1)dd 補零(01)EEE 縮寫(Sun、Mon、Tue、Wed、Thu、Fri、Sat)EEEE 全名(Sunday、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday)h 12 小時制,不補零(1:15:15 PM)hh 12 小時制,補零(01:15:15 PM)H 24 小時制,不補零(1:15:15)HH 24 小時制,補零(01:15:15)m 不補零(12:1:15)mm 補零(12:01:15)s 不補零(12:15:5)ss 補零(12:15:05)f / ff / ffff 秒的小數部分,分別精確到十分之一、百分之一、萬分之一秒(最多可用七個 f)t 12 小時制下,中午前顯示 A,中午到 23:59 顯示 Ptt 顯示 AM / PM;若地區設定採 24 小時制則不顯示任何字元z 不補零的時區偏移量zz 補零偏移量(-08)zzz 完整偏移量(-0800)針對 "Sun May 24 13:59:03 +0800 2015" 這種常見的網路時間格式:
/// 根據指定格式的日期字串建立日期物件
/// dateString 為 "Sun May 24 13:59:03 +0800 2015"
class func createDate(dateSring: String) -> NSDate? {
let df = NSDateFormatter()
df.locale = NSLocale(localeIdentifier: "en_US")
df.dateFormat = "EEE MMM dd HH:mm:ss zzz yyyy"
return df.dateFromString(dateSring)
}
把解析邏輯收攏到一個方法,避免格式字串散落在專案各處。
/// 從字串解析出精確時間
/// dateString 時間字串
/// formatString 對應的格式
class func getDate(dateString: String, formatString: String) -> NSDate? {
// 1. 建立格式化物件
let df = NSDateFormatter()
// 2. 指定地區。這一步不可省略,
// 真機除錯時若不指定 locale,轉換常會失敗
df.locale = NSLocale(localeIdentifier: "en_US")
// 3. 設定格式
df.dateFormat = formatString
// 4. 輸出結果
return df.dateFromString(dateString)
}
實務上最關鍵的觀念是:NSDateFormatter 是有狀態且建立成本不低的物件,如果同一種格式要重複解析大量資料,應該把 formatter 快取出來共用(並注意執行緒安全),而不是在迴圈裡反覆 new。另外,若要顯示給使用者看的時間,記得反過來用 NSDateFormatterStyle 系列或 dateStyle / timeStyle 讓系統依地區自動決定樣式,別自己硬寫格式字串。
至於日期的加減、比較、取得一週第一天這類運算,交給 NSCalendar 與 NSDateComponents 處理會比手算精準得多,特別是遇到閏年、夏令時間這類邊界情況時。