日期處理幾乎每個 App 都躲不掉,但 NSDate 的 API 命名有點繞。這一篇把建立、比較、取時間差與轉字串這四類最常見的操作整理清楚。
類方法(Class Method)這幾個最常用:
+ (id)date; // 現在時間 + (id)dateWithTimeIntervalSinceNow:(NSTimeInterval)secs; // 以現在為基準,往後 secs 秒 + (id)dateWithTimeIntervalSinceReferenceDate:(NSTimeInterval)secs; // 以 2001/01/01 GMT 為基準 + (id)dateWithTimeIntervalSince1970:(NSTimeInterval)secs; // 以 1970/01/01 GMT 為基準 + (id)distantFuture; // 很遠的未來(實測 4000/12/31 16:00:00) + (id)distantPast; // 很遠的過去(實測 公元前 0001/12/31 17:00:00)
distantFuture 與 distantPast 常被拿來當「無限大/無限小」的哨兵值,例如排序或區間判斷時很好用。
實例方法則是「在目前這個時間上再加一段」:
- (id)addTimeInterval:(NSTimeInterval)secs; // 以 instance 內保存的時間為基準,往後 secs 秒
初始化方法與上面的類方法幾乎一一對應:
- (id)init; // 現在時間,等同 date - (id)initWithTimeIntervalSinceReferenceDate:(NSTimeInterval)secs; - (id)initWithTimeInterval:(NSTimeInterval)secs sinceDate:(NSDate *)refDate; - (id)initWithTimeIntervalSinceNow:(NSTimeInterval)secs;
- (BOOL)isEqualToDate:(NSDate *)otherDate; // 相同回傳 YES - (NSDate *)earlierDate:(NSDate *)anotherDate; // 回傳較早的那個 - (NSDate *)laterDate:(NSDate *)anotherDate; // 回傳較晚的那個
需要排序時用 compare:,回傳值是三向的:
- (NSComparisonResult)compare:(NSDate *)other; // NSOrderedAscending :自己比對方早 // NSOrderedSame :兩者相同 // NSOrderedDescending :自己比對方晚
- (NSTimeInterval)timeIntervalSinceDate:(NSDate *)refDate; // 相對 refDate 的間隔 - (NSTimeInterval)timeIntervalSinceNow; // 相對現在 - (NSTimeInterval)timeIntervalSince1970; // 相對 1970/01/01 GMT - (NSTimeInterval)timeIntervalSinceReferenceDate; // 相對 2001/01/01 GMT + (NSTimeInterval)timeIntervalSinceReferenceDate; // 現在時間距 2001 的秒數
單位一律是「秒」,型別是 NSTimeInterval(實際上是 double),所以要做倒數計時、計算兩個日期差幾天,直接相除即可。
- (NSString *)description; // 輸出格式:YYYY-MM-DD HH:MM:SS ±HHMM
其中 ±HHMM 是與 GMT 的時區差。若系統時區設為台北,就會顯示成 +0800。要更自由地控制格式,則需改用 NSDateFormatter。