
做 iOS 開發,遲早會撞上各種時間問題:8 小時時差、時間戳、求時間間隔、農曆換算……網上的解法很多,但往往零碎,而且很少說清背後的原因。這裡做個集中整理,方便以後查閱,也給大家做參考。文中帶有我個人的理解,錯漏之處歡迎吐槽。
用 [NSDate date] 初始化出來的時間,拿到的是零時區(格林尼治)時間,格式形如「年-月-日 時:分:秒 +時區」;而北京時間屬於東八區。時區不同,打印出來自然差 8 小時,但兩者描述的是同一個時間點。
NSDate *date = [NSDate date]; NSLog(@"date時間 = %@", date); NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; [formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss Z"]; NSString *dateStr = [formatter stringFromDate:date]; NSLog(@"字符串時間 = %@", dateStr);
打印結果:
2016-12-07 10:44:24.470 timeTest[32743:2995134] date時間 = 2016-12-07 02:44:24 +0000 2016-12-07 10:44:24.471 timeTest[32743:2995134] 字符串時間 = 2016-12-07 10:44:24 +0800
NSLog 打印的系統時間是北京時間 10:44:24.470,而 date 打出來少了 8 小時,因為它是零時區(+0000)的 02:44:24。同一刻換算到東八區正是 10:44:24。就像 1 公斤和 2 斤,計量單位不同,重量並沒有變。
也就是說,系統默認把 [NSDate date] 當作零時區時間,而經過 NSDateFormatter 轉成字符串後,得到的就是當前時區的準確時間,並不存在真正的 8 小時誤差。
上面那段代碼沒有設置 NSDateFormatter 的 timeZone,此時默認使用當前所在時區,效果等同於 formatter.timeZone = [NSTimeZone systemTimeZone]。
當然也可以主動指定時區,拿到指定地區的字符串時間:
NSDate *date = [NSDate date]; NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; [formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"]; formatter.timeZone = [NSTimeZone timeZoneWithName:@"Asia/Shanghai"];//東八區時間 NSString *dateStr = [formatter stringFromDate:date]; NSLog(@"字符串時間 = %@", dateStr);
這時無論手機系統時區設成哪裡,輸出都是東八區時間,因為時區已經被寫死了。其他寫法:
formatter.timeZone = [NSTimeZone timeZoneWithName:@"Asia/Tokyo"];//東九區時間 formatter.timeZone = [NSTimeZone timeZoneWithName:@"GMT"];//零區時間
想知道系統支持哪些時區標識,可以這樣列出來:
NSArray *zones = [NSTimeZone knownTimeZoneNames]; for (NSString *zone in zones) { NSLog(@"時區名 = %@", zone); }
時區對照表
反方向的轉換同樣會遇到時區問題,也就是所謂的「8 小時誤差」,本質仍是時區不同:
NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; [formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss Z"]; NSDate *newDate = [formatter dateFromString:@"2016-12-07 14:06:24 +0800"]; NSLog(@"newDate = %@", newDate);
打印結果:
2016-12-07 14:12:17.468 timeTest[34279:3155380] newDate = 2016-12-07 06:06:24 +0000
格式裡的 Z 代表時區,待轉字符串的格式必須與之匹配。上面給的是東八區的 14:06:24,轉成 NSDate 後是零時區的 06:06:24 +0000,字面上少了 8 小時,實際時間一致。
如果換成 @"2016-12-07 14:06:24 +0000",轉出來的 NSDate 打印值會完全相同,因為它本身就是零時區時間,不存在換算。可以自己試試。
若不打算在字符串裡帶時區(即去掉後面的 +0800),同時要把格式字串裡的 Z 去掉,保證格式匹配。此時系統會認為該字符串是所在時區的時間,轉出的 NSDate 則是零時區時間。
同樣,也可以用 formatter.timeZone = [NSTimeZone timeZoneWithName:@"GMT"]; 來指定字符串的時區,效果與 Z 對應 +0000 一致。
因為 [NSDate date] 是零時區時間,有些人為了「拿到本時區的 NSDate」會這樣寫:
NSDate *date = [NSDate date]; NSTimeZone *zone = [NSTimeZone systemTimeZone]; NSInteger interval = [zone secondsFromGMTForDate:date]; NSDate *localDate = [date dateByAddingTimeInterval:interval]; NSLog(@"localDate = %@",localDate);
打印結果:
2016-12-07 14:49:03.777 timeTest[34519:3183548] localDate = 2016-12-07 14:49:03 +0000
這裡 zone 是當前時區,interval 是當前時區與零時區的差值,localDate 就是零時區時間加上這個差值。更粗暴的寫法是直接加 8*60*60 或 28800——在東八區看起來沒問題,換個時區就全錯了。
但這種做法本身就不靠譜:算出來的結果仍然是零時區時間,末尾明明白白掛著 +0000,只是日常使用中一般不展示時區,才讓人誤以為它是本地時間。這是個大坑。
坑 1:拿這個 localDate 再去轉字符串,又會多出 8 小時,因為格式化時系統仍把它當零時區處理。想「將錯就錯」,就得把字符串也按零時區來格式化,於是從深坑跳進更深的坑:
NSDate *date = [NSDate date]; NSTimeZone *zone = [NSTimeZone systemTimeZone]; NSInteger interval = [zone secondsFromGMTForDate:date]; NSDate *localDate = [date dateByAddingTimeInterval:interval]; NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; [formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"]; formatter.timeZone = [NSTimeZone timeZoneWithName:@"UTC"]; NSString *dateStr = [formatter stringFromDate:localDate]; NSLog(@"字符串時間 = %@", dateStr);
這裡的 UTC 是世界標準時間,東八區比它快 8 小時;填 GMT 也可以。
坑 2:與後台交互時,如果對方要求 +0000 時區,你只能手動拼接字符串去改時區字段。
所以結論很明確:開發中需要顯示、存儲或與後台交互時,一律使用字符串時間,不要拿「轉過時區的 NSDate」去折騰。
時間戳指 1970 年 1 月 1 日 0 時 0 分 0 秒到現在的秒數。注意:這裡的「現在」指的是零時區的 NSDate 時間。
NSDate *date = [NSDate date]; NSTimeInterval timeIn = [date timeIntervalSince1970]; NSLog(@"時間戳 = %.0f", timeIn);
打印結果:
2016-12-07 15:41:04.000 timeTest[34994:3232390] 時間戳 = 1481096464
NSDate *date = [NSDate date]; NSTimeInterval timeIn = [date timeIntervalSince1970]; NSDate *newDate = [NSDate dateWithTimeIntervalSince1970:timeIn]; NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init]; [dateFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss Z"]; NSString *newTime = [dateFormatter stringFromDate:newDate]; NSLog(@"初始化時間 = %@,時間戳=%.0f,時間戳轉為NSDate時間 = %@,轉為字符串時間 = %@", date, timeIn, newDate, newTime);
打印結果:
2016-12-07 16:11:56.146 timeTest[35186:3253589] 初始化時間 = 2016-12-07 08:11:56 +0000,時間戳=1481098316,時間戳轉為NSDate時間 = 2016-12-07 08:11:56 +0000,轉為字符串時間 = 2016-12-07 16:11:56 +0800
再強調一遍:算時間戳要用零時區的 NSDate。不要先把它轉成本地時區的 NSDate 再算。下面是一組對比驗證:
NSDate *date = [NSDate date]; NSLog(@"系統零時區NSDate時間 = %@", date); NSTimeInterval timeIn = [date timeIntervalSince1970]; NSLog(@"系統零時區NSDate時間轉化為時間戳 = %.0f", timeIn); NSTimeZone *zone = [NSTimeZone systemTimeZone]; NSInteger interval = [zone secondsFromGMTForDate:date]; NSDate *localDate = [date dateByAddingTimeInterval:interval]; NSLog(@"轉化為本地NSDate時間 = %@", localDate); NSTimeInterval timeIn2 = [localDate timeIntervalSince1970]; NSLog(@"本地NSDate時間轉化為時間戳 = %.0f", timeIn2); NSDate *detaildate = [NSDate dateWithTimeIntervalSince1970:timeIn]; NSDate *detaildate2 = [NSDate dateWithTimeIntervalSince1970:timeIn2]; NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init]; [dateFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss Z"]; NSString *newTime = [dateFormatter stringFromDate:detaildate]; NSString *newTime2 = [dateFormatter stringFromDate:detaildate2]; NSLog(@"最終轉為字符串時間1 = %@, 時間2 = %@", newTime, newTime2);
打印結果:
2016-12-07 16:13:57.834 timeTest[35211:3255842] 系統零時區NSDate時間 = 2016-12-07 08:13:57 +0000 2016-12-07 16:13:57.834 timeTest[35211:3255842] 系統零時區NSDate時間轉化為時間戳 = 1481098438 2016-12-07 16:13:57.835 timeTest[35211:3255842] 轉化為本地NSDate時間 = 2016-12-07 16:13:57 +0000 2016-12-07 16:13:57.835 timeTest[35211:3255842] 本地NSDate時間轉化為時間戳 = 1481127238 2016-12-07 16:13:57.836 timeTest[35211:3255842] 最終轉為字符串時間1 = 2016-12-07 16:13:57 +0800, 時間2 = 2016-12-08 00:13:57 +0800
兩個時間戳差了整整 28800 秒,最終字符串也差了 8 小時——原因見上文「NSDate 轉當前時區的 NSDate」。
//初始化當前時間,返回零時區時間 NSDate *date = [NSDate date]; //以當前時間為准,正數超前指定秒數,負數延後指定秒數 NSDate *laterDate = [NSDate dateWithTimeIntervalSinceNow:60]; //以2001-01-01 00:00:00 +0000為基准,正數超前指定秒數,負數延後指定秒數 NSDate *newDate = [NSDate dateWithTimeIntervalSinceReferenceDate:60]; //以1970-01-01 00:00:00 +0000為基准,正數超前指定秒數,負數延後指定秒數 NSDate *newDate1 = [NSDate dateWithTimeIntervalSince1970:60]; //實例方法,以指定時間為基准,正數超前指定秒數,負數延後指定秒數 NSDate *newDate2 = [date dateByAddingTimeInterval:60]; //很久以後的某一天 NSDate *newDate3 = [NSDate distantFuture]; //很久以前的某一天 NSDate *newDate4 = [NSDate distantPast];
//比較兩個時間是否相等 - (BOOL)isEqualToDate:(NSDate *)otherDate; //兩個時間比較,返回較早時間 - (NSDate *)earlierDate:(NSDate *)anotherDate; //兩個時間比較,返回較晚時間 - (NSDate *)laterDate:(NSDate *)anotherDate; //兩個時間比較,返回枚舉類型 - (NSComparisonResult)compare:(NSDate *)other;
//返回實例時間與refDate時間間隔秒數 - (NSTimeInterval)timeIntervalSinceDate:(NSDate *)refDate; //返回實例時間與當前時間間隔秒數 - (NSTimeInterval)timeIntervalSinceNow; //返回實例時間的時間戳 - (NSTimeInterval)timeIntervalSince1970; //返回實例時間和2001-01-01 00:00:00 +0000的間隔秒數 - (NSTimeInterval)timeIntervalSinceReferenceDate; //返回當前時間和2001-01-01 00:00:00 +0000的間隔秒數 + (NSTimeInterval)timeIntervalSinceReferenceDate;
OC 的時間 API 坑不少,沒法像別的語言那樣 time.year 直接取值。要拿到 NSDate 的年月日,必須借助日曆對象 NSCalendar。
NSDate *date = [NSDate date]; NSCalendar *cal = [NSCalendar currentCalendar]; NSDateComponents *dateComps = [cal components:NSCalendarUnitYear|NSCalendarUnitMonth|NSCalendarUnitDay|NSCalendarUnitHour|NSCalendarUnitMinute|NSCalendarUnitSecond|NSCalendarUnitWeekday|NSCalendarUnitWeekOfMonth|NSCalendarUnitWeekOfYear|NSCalendarUnitTimeZone fromDate:date]; NSLog(@"時間 = %@", date); NSLog(@"年=%ld,月=%ld,日=%ld,時=%ld,分=%ld,秒=%ld,周=%ld,本月第%ld周,本年第%ld周,時區=%@", dateComps.year, dateComps.month, dateComps.day, dateComps.hour, dateComps.minute, dateComps.second, dateComps.weekday, dateComps.weekOfMonth, dateComps.weekOfYear, dateComps.timeZone.name);
打印結果:
2016-12-07 17:20:41.639 timeTest[35734:3311752] 時間 = 2016-12-07 09:20:41 +0000 2016-12-07 17:20:41.640 timeTest[35734:3311752] 年=2016,月=12,日=7,時=17,分=20,秒=41,周=4,本月第2周,本年第50周,時區=Asia/Shanghai
傳入 components: 的 NSCalendarUnit 枚舉,必須覆蓋你後面要取的字段——想拿 dateComps.year,就得帶上 NSCalendarUnitYear。
可以看到,[NSDate date] 的時間通過 NSCalendar 能直接取出當前時區的時分秒(從打印的時和時區就能看出),這是因為用的是 [NSCalendar currentCalendar]。也可以改用 [[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian] 顯式指定陽曆;如果把 Identifier 換成 NSCalendarIdentifierChinese,打印出來的就是中國農曆。
另外幾個字段含義:
weekOfMonth:今天是本月的第幾週。
weekOfYear:今天是本年的第幾週。
weekday:星期。這裡和日常習慣不同——上面輸出「周=4」,而 2016-12-07 其實是週三。對應關係是:週日-1、週一-2、週二-3、週三-4、週四-5、週五-6、週六-7,因為國外慣例把週日當作一週的第一天。
下面是一個農曆換算的工具方法,可按需擴充農曆節日與二十四節氣。
+ (NSString *)LunarForSolarYear:(int)wCurYear Month:(int)wCurMonth Day:(int)wCurDay { //農歷日期名 NSArray *cDayName = [NSArray arrayWithObjects:@"*",@"初一",@"初二",@"初三",@"初四",@"初五",@"初六",@"初七",@"初八",@"初九",@"初十",@"十一",@"十二",@"十三",@"十四",@"十五",@"十六",@"十七",@"十八",@"十九",@"二十",@"廿一",@"廿二",@"廿三",@"廿四",@"廿五",@"廿六",@"廿七",@"廿八",@"廿九",@"三十",nil]; //農歷月份名 NSArray *cMonName = [NSArray arrayWithObjects:@"*",@"正月",@"二月",@"三月",@"四月",@"五月",@"六月",@"七月",@"八月",@"九月",@"十月",@"冬月",@"臘月",nil]; //公歷每月前面的天數 const int wMonthAdd[12] = {0,31,59,90,120,151,181,212,243,273,304,334}; //農歷數據 const int wNongliData[100] = {2635,333387,1701,1748,267701,694,2391,133423,1175,396438 ,3402,3749,331177,1453,694,201326,2350,465197,3221,3402 ,400202,2901,1386,267611,605,2349,137515,2709,464533,1738 ,2901,330421,1242,2651,199255,1323,529706,3733,1706,398762 ,2741,1206,267438,2647,1318,204070,3477,461653,1386,2413 ,330077,1197,2637,268877,3365,531109,2900,2922,398042,2395 ,1179,267415,2635,661067,1701,1748,398772,2742,2391,330031 ,1175,1611,200010,3749,527717,1452,2742,332397,2350,3222 ,268949,3402,3493,133973,1386,464219,605,2349,334123,2709 ,2890,267946,2773,592565,1210,2651,395863,1323,2707,265877}; static int nTheDate,nIsEnd,m,k,n,i,nBit; //計算到初始時間1921年2月8日的天數:1921-2-8(正月初一) nTheDate = (wCurYear - 1921) * 365 + (wCurYear - 1921) / 4 + wCurDay + wMonthAdd[wCurMonth - 1] - 38; if((!(wCurYear % 4)) & (wCurMonth > 2)) nTheDate = nTheDate + 1; //計算農歷天干、地支、月、日 nIsEnd = 0; m = 0; while(nIsEnd != 1) { if(wNongliData[m] < 4095) k = 11; else k = 12; n = k; while(n>=0) { //獲取wNongliData(m)的第n個二進制位的值