NSDateFormatter对象的作用,就是把NSDate对象转换为字符串,以及将字符串转换成NSDate。
1. 利用NSDateFormatterStyle枚举值将NSDate对象转换为字符串
NSDate对象表示的是一个时间,包括了日期,也包括了时分秒。所以NSDateFormatter也有两个方法,分别用来表示时间的日期和时分秒。
1.1 表示日期的方法
NSDateFormatter的setDateStyle:方法,用来设置日期的表示法。
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
[dateFormatter setDateStyle:NSDateFormatterFullStyle];
NSDate *currentDate = [NSDate date];
NSString *dateString = [dateFormatter stringFromDate:currentDate];
NSLog(@"current date string: %@", dateString); // 2017年8月3日 星期四
代码中的NSDateFormatterFullStyle是NSDateFormatterStyle枚举值,一共五个。它们所能表现的形式如下:
[dateFormatter setDateStyle:NSDateFormatterNoStyle]; // 不产生任何效果
[dateFormatter setDateStyle:NSDateFormatterShortStyle]; // 2017/8/3
[dateFormatter setDateStyle:NSDateFormatterMediumStyle]; // 2017年8月3日
[dateFormatter setDateStyle:NSDateFormatterLongStyle]; // 2017年8月3日
[dateFormatter setDateStyle:NSDateFormatterFullStyle]; // 2017年8月3日 星期四
1.2 表示时分秒的方法
NSDateFormatter的setTimeStyle:方法,用来设置时分秒的表示法。
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
[dateFormatter setTimeStyle:NSDateFormatterFullStyle];
NSDate *currentDate = [NSDate date];
NSString *dateString = [dateFormatter stringFromDate:currentDate];
NSLog(@"current date string: %@", dateString); // 中国标准时间 下午2:53:42
使用和上面一样的NSDateFormatterStyle枚举值。它们在时分秒上的表现如下:
[dateFormatter setTimeStyle:NSDateFormatterNoStyle]; // 不产生任何效果
[dateFormatter setTimeStyle:NSDateFormatterShortStyle]; // 下午2:51
[dateFormatter setTimeStyle:NSDateFormatterMediumStyle]; // 下午2:52:25
[dateFormatter setTimeStyle:NSDateFormatterLongStyle]; // GMT+8 下午2:52:25
[dateFormatter setTimeStyle:NSDateFormatterFullStyle]; // 中国标准时间 下午2:53:42
2. 利用格式字符串将NSDate对象转换成字符串
使用格式字符串,就要使用NSDateFormatter的setDateFormat:方法。
NSDateFormatter *dateStringFormatter = [[NSDateFormatter alloc] init];
[dateStringFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];
NSDate *currentDate = [NSDate date];
NSLog(@"date string: %@", [dateStringFormatter stringFromDate:currentDate]); // 2017-08-03 16:13:03
格式字符串的格式是使用Unicode Technical Standard #35标准。下面是对常用格式的列举(注释部分就是结果字符串的样例):
[dateStringFormatter setDateFormat:@"y"]; // 2017
[dateStringFormatter setDateFormat:@"yy"]; // 17
[dateStringFormatter setDateFormat:@"yyy"]; // 2017
[dateStringFormatter setDateFormat:@"yyyy"]; // 2017
[dateStringFormatter setDateFormat:@"M"]; // 8
[dateStringFormatter setDateFormat:@"MM"]; // 08
[dateStringFormatter setDateFormat:@"MMM"]; // 8月
[dateStringFormatter setDateFormat:@"MMMM"]; // 八月
[dateStringFormatter setDateFormat:@"d"]; // 3
[dateStringFormatter setDateFormat:@"dd"]; // 03
[dateStringFormatter setDateFormat:@"D"]; // 215,一年中的第几天
[dateStringFormatter setDateFormat:@"h"]; // 4
[dateStringFormatter setDateFormat:@"hh"]; // 04
[dateStringFormatter setDateFormat:@"H"]; // 16 24小时制
[dateStringFormatter setDateFormat:@"HH"]; // 16
[dateStringFormatter setDateFormat:@"m"]; // 28
[dateStringFormatter setDateFormat:@"mm"]; // 28
[dateStringFormatter setDateFormat:@"s"]; // 57
[dateStringFormatter setDateFormat:@"ss"]; // 04
[dateStringFormatter setDateFormat:@"E"]; // 周四
[dateStringFormatter setDateFormat:@"EEEE"]; // 星期四
[dateStringFormatter setDateFormat:@"EEEEE"]; // 四
[dateStringFormatter setDateFormat:@"e"]; // 5 (显示的是一周的第几天(weekday),1为周日。)
[dateStringFormatter setDateFormat:@"ee"]; // 05
[dateStringFormatter setDateFormat:@"eee"]; // 周四
[dateStringFormatter setDateFormat:@"eeee"]; // 星期四
[dateStringFormatter setDateFormat:@"eeeee"]; // 四
[dateStringFormatter setDateFormat:@"z"]; // GMT+8
[dateStringFormatter setDateFormat:@"zzzz"]; // 中国标准时间
[dateStringFormatter setDateFormat:@"ah"]; // 下午5
[dateStringFormatter setDateFormat:@"aH"]; // 下午17
[dateStringFormatter setDateFormat:@"am"]; // 下午53
[dateStringFormatter setDateFormat:@"as"]; // 下午52
3. 利用格式字符串和区域标识(NSLocale)符来自定义格式字符串
不同的国家或地区有着不同的显示时间的习惯。使用NSDateFormatter的dateFormatFromTemplate:options:locale:方法可以自定义一个格式字符串出来。
NSLocale *locale = [[NSLocale alloc] initWithLocaleIdentifier:@"zh_CN"];
NSString *formatString = [NSDateFormatter dateFormatFromTemplate:@"EEEEMMMyyyyddahmmss" options:0 locale:locale];
NSDateFormatter *localeDateFormatter = [[NSDateFormatter alloc] init];
[localeDateFormatter setDateFormat:formatString];
NSString *localeTemplateString = [localeDateFormatter stringFromDate:currentDate];
NSLog(@"locale & template date: %@", localeTemplateString); // 2017年8月03日 星期四 下午9:00:09
@"zh_CN"是区域标识符。常用的还有@"en_US"和@"en_GB".更多的标识符可以参考这里。
上述代码中的Template字符串改成@"yyyyMMMddahmmssEEEE",其最后的结果字符串还是一样的。这说明字符串的本身顺序不重要。当然,你不能写成“yMyyEdsEEyE”这样的形式。
4. 将字符串转换为NSDate对象
使用NSDateFormatter的dateFromString:方法来完成这个转换。这种转换的关键在于,你需要知道,被转换的字符串所表示的日期是以哪个区域的哪种格式呈现的。比如下面这个例子中,要被转换的字符串说表示的日期是,@“en_US_POSIX”区域(它比@“en_US”更加特值美国),@“yyyy-MM-dd HH:mm:ss”的格式。这些都是符合RFC3339标准。
NSDateFormatter *rfc3339DateFormatter = [[NSDateFormatter alloc] init];
NSLocale *enUSPOSIXLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US_POSIX"];
[rfc3339DateFormatter setLocale:enUSPOSIXLocale];
[rfc3339DateFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];
[rfc3339DateFormatter setTimeZone:[NSTimeZone localTimeZone]];
// 借用前面的NSDateFormatter对象和NSDate对象
[dateStringFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];
NSString *rfc3339String = [dateStringFormatter stringFromDate:currentDate];
NSDate *date = [rfc3339DateFormatter dateFromString:rfc3339String];
NSString *userVisibleDateTimeString;
if (date != nil) {
NSDateFormatter *userVisibleDateFormatter = [[NSDateFormatter alloc] init];
[userVisibleDateFormatter setDateStyle:NSDateFormatterShortStyle];
[userVisibleDateFormatter setTimeStyle:NSDateFormatterShortStyle];
userVisibleDateTimeString = [userVisibleDateFormatter stringFromDate:date];
}
NSLog(@"user visible date time string: %@", userVisibleDateTimeString); // 2017/8/4 下午3:05 (所处时区不同,最终显示的时间结果也会不同。)
这里的关键是,dateFromString:的字符串参数和setDateFormat:的字符串参数的格式要匹配。
NSDateFormatter的常用功能介绍完毕。
文中的例子参考iOS开发文档 Date Fromatters。中文翻译版见 日期格式化器 。