NSDateFormatter的一些使用参考

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。中文翻译版见 日期格式化器 。

你可能感兴趣的:(NSDateFormatter的一些使用参考)