在 iOS 開發中,日期與時間的處理幾乎無處不在:顯示當前時間、格式化時間戳、計算兩個時刻的間隔、判斷星期幾,甚至換算農曆節氣。本文以 Objective-C 為例,系統整理常見的日期操作套路,方便日後查閱與複用。
核心工具是 NSDateFormatter。透過設定 locale 與 dateFormat,就能把 NSDate 輸出成字串:
NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; [formatter setLocale:[[NSLocale alloc] initWithLocaleIdentifier:@"en_US"]]; [formatter setDateFormat:@"yy-MM-dd HH:mm"]; NSString *currentTime = [formatter stringFromDate:[NSDate date]];
後端常回傳 1970 年以來的秒數(時間戳),此時可指定時區後再格式化:
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init]; dateFormatter.timeZone = [NSTimeZone timeZoneWithName:@"Asia/Shanghai"]; [dateFormatter setDateFormat:@"yyyy-MM-dd HH:mm"]; NSDate *theday = [NSDate dateWithTimeIntervalSince1970:[time integerValue]]; NSString *day = [dateFormatter stringFromDate:theday];
把「2012-11-20」轉成「2012年11月20日」,只需更換格式字串即可:
NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; [formatter setDateFormat:@"yyyy-MM-dd"]; NSDate *date = [formatter dateFromString:time]; [formatter setDateFormat:@"yyyy年MM月dd日"]; NSString *day = [formatter stringFromDate:date];
將兩個時刻轉為時間戳後相減,即可得到相差的秒數,再換算成天、時、分:
- (NSString *)theTime:(NSString *)issueTime {
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
[formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];
NSDate *date = [formatter dateFromString:issueTime];
NSTimeInterval late = [date timeIntervalSince1970];
NSTimeInterval now = [[NSDate date] timeIntervalSince1970];
NSTimeInterval cha = now - late;
if (cha < 60) {
return [NSString stringWithFormat:@"%.0f秒前", cha];
} else if (cha < 3600) {
return [NSString stringWithFormat:@"%.0f分鐘前", cha / 60];
} else if (cha < 86400) {
return [NSString stringWithFormat:@"%.0f小時前", cha / 3600];
}
return [NSString stringWithFormat:@"%.0f天前", cha / 86400];
}
利用 NSCalendar 取出星期幾的整數值,再對照中文即可(注意:1 代表週日):
- (NSString *)getWeekDayByDate:(NSDate *)date {
NSCalendar *calendar = [NSCalendar currentCalendar];
NSDateComponents *comp = [calendar components:NSWeekdayCalendarUnit fromDate:date];
NSArray *weekDays = @[@"星期日", @"星期一", @"星期二", @"星期三",
@"星期四", @"星期五", @"星期六"];
return [weekDays objectAtIndex:([comp weekday] - 1)];
}
iOS 內建 NSChineseCalendar,可直接取得農曆的年月日,再對照表即可判斷傳統節日:
+(NSString *)getLunarHoliDayDate:(NSDate *)date {
NSCalendar *localeCalendar = [[NSCalendar alloc] initWithCalendarIdentifier:NSChineseCalendar];
unsigned unitFlags = NSYearCalendarUnit | NSMonthCalendarUnit | NSDayCalendarUnit;
NSDateComponents *comp = [localeCalendar components:unitFlags fromDate:date];
if (1 == comp.month && 1 == comp.day) {
return @"除夕";
}
NSDictionary *holidays = [NSDictionary dictionaryWithObjectsAndKeys:
@"春節", @"1-1", @"元宵", @"1-15", @"端午", @"5-5",
@"七夕", @"7-7", @"中秋", @"8-15", @"重陽", @"9-9", nil];
NSString *key = [NSString stringWithFormat:@"%d-%d", comp.month, comp.day];
return [holidays objectForKey:key];
}
至於二十四節氣,由於其對應的是太陽運行位置而非固定農曆日期,實務上多半採用一份預先整理好的年份對照表(例如涵蓋 1901 至 2050 年的壓縮資料表),透過位元運算推算當月節氣落在哪一天,再回傳「立春、雨水、驚蟄……」等名稱。
天干地支、農曆月、農曆日的文字,可各自用陣列對照,再組合輸出:
+(NSString*)getChineseCalendarWithDate:(NSDate *)date {
NSArray *chineseMonths = @[@"正月", @"二月", @"三月", @"四月", @"五月", @"六月",
@"七月", @"八月", @"九月", @"十月", @"冬月", @"臘月"];
NSArray *chineseDays = @[@"初一", @"初二", @"初三", @"初四", @"初五", @"初六", @"初七",
@"初八", @"初九", @"初十", @"十一", @"十二", @"十三", @"十四", @"十五",
@"十六", @"十七", @"十八", @"十九", @"二十", @"廿一", @"廿二", @"廿三",
@"廿四", @"廿五", @"廿六", @"廿七", @"廿八", @"廿九", @"三十"];
NSCalendar *localeCalendar = [[NSCalendar alloc] initWithCalendarIdentifier:NSChineseCalendar];
unsigned unitFlags = NSYearCalendarUnit | NSMonthCalendarUnit | NSDayCalendarUnit;
NSDateComponents *comp = [localeCalendar components:unitFlags fromDate:date];
NSString *m_str = [chineseMonths objectAtIndex:comp.month - 1];
NSString *d_str = [chineseDays objectAtIndex:comp.day - 1];
return [NSString stringWithFormat:@"%@%@", m_str, d_str];
}
把常用的「字串 + 格式」封裝成一個方法,處理由後端傳來的日期字串會更省事:
+(NSDate *)getDateWithDateString:(NSString *)strDate formatString:(NSString *)strFormat {
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
[formatter setTimeZone:[NSTimeZone timeZoneWithAbbreviation:@"GMT"]];
[formatter setDateFormat:strFormat];
return [formatter dateFromString:strDate];
}
// 使用範例
NSDate *date = [Tool_Functions getDateWithDateString:@"2012-12-21 15:14:35"
formatString:@"yyyy-MM-dd HH:mm:ss"];
掌握 NSDateFormatter 的格式字串、NSCalendar 的元件抽取,以及時間戳的加減運算,絕大多數 iOS 日期需求都能迎刃而解。若日後要處理農曆節氣,記得預先準備好對照資料表。