時間是應用程式裡最容易被低估的複雜主題。時區、夏令時間、系統時鐘變動、使用者手動改時間……這些都可能讓「日期」變成燙手山芋。NSDate 的設計哲學其實相當克制:它只負責描述「一個絕對的時間點」,其餘一概不管。
NSObjectNSCopying、NSSecureCodingNSDate.hNSDate 的本質是一個「從某個參考時刻起算的秒數」。它認定的參考時刻是 2001 年 1 月 1 日 00:00:00 GMT(即 timeIntervalSinceReferenceDate 為 0 的那一刻);同時它也認得另一個更常見的基準——1970 年 1 月 1 日(Unix 紀元)。理解這兩套基準,是讀懂所有 NSDate API 的前提。
+date+dateWithTimeIntervalSinceNow:、-initWithTimeIntervalSinceNow:+dateWithTimeInterval:sinceDate:、-initWithTimeInterval:sinceDate:+dateWithTimeIntervalSinceReferenceDate:、-initWithTimeIntervalSinceReferenceDate:+dateWithTimeIntervalSince1970:、-initWithTimeIntervalSince1970:-init與伺服器交換時間資料時,多半會用到 timeIntervalSince1970 系列,因為那是跨語言通用的共識。
+distantPast 與 +distantFuture 提供兩個極端值,常用作排序比較的哨兵,或表示「無限期」這類語意。
-isEqualToDate:、-earlierDate:、-laterDate:、-compare: 四個方法構成完整的比較能力。其中 -compare: 回傳 NSComparisonResult,最適合放進排序 block 裡使用。
-timeIntervalSinceDate: 算出兩個日期相差幾秒;-timeIntervalSinceNow 算出與當下的差距;+timeIntervalSinceReferenceDate、-timeIntervalSinceReferenceDate、-timeIntervalSince1970 則是與基準點的距離。所有結果單位一律是「秒」,型別為 NSTimeInterval。
-dateByAddingTimeInterval: 回傳一個新的日期物件,不改變原物件,這是不可變物件的典型風格。舊有的 -addTimeInterval: 會就地修改,已在 iOS 4.0 被標記為淘汰,新專案請一律採用前者。
-description 給出預設格式,-descriptionWithLocale: 則能依地區調整呈現方式。不過在真正的 UI 場景裡,更推薦搭配 NSDateFormatter 或 NSDateComponentsFormatter,彈性大得多。
因為 NSDate 描述的是「時間軸上的一個絕對位置」,而時區只是一種呈現方式。當你需要「2026 年 8 月 31 日下午三點,台北時間」這種帶有時區語意的表示,就該改用 NSDateComponents 搭配 NSCalendar 與 NSTimeZone。把絕對時刻與曆法表示分開處理,正是 Cocoa 時間 API 設計上的關鍵決定。
資料來源:Apple Inc. NSDate Class Reference(更新日期 2013-09-18)