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
常用参数
参数 | 说明 |
---|---|
a | AM/PM (上午/下午) |
A | 0~86399999 (一天的第A微秒) |
c/cc | 1~7 (一周的第一天, 周天为1) |
ccc | Sun/Mon/Tue/Wed/Thu/Fri/Sat (星期几简写) |
cccc | Sunday/Monday/Tuesday/Wednesday/Thursday/Friday/Saturday (星期几全拼) |
d | 1~31 (月份的第几天, 带0) |
D | 1~366 (年份的第几天,带0) |
e | 1~7 (一周的第几天, 带0) |
E~EEE | Sun/Mon/Tue/Wed/Thu/Fri/Sat (星期几简写) |
EEEE | Sunday/Monday/Tuesday/Wednesday/Thursday/Friday/Saturday (星期几全拼) |
F | 1~5 (每月的第几周, 一周的第一天为周一) |
g | Julian Day Number (number of days since 4713 BC January 1) 未知 |
G~GGG | BC/AD (Era Designator Abbreviated) 未知 |
GGGG | Before Christ/Anno Domini 未知 |
h | 1~12 (0 padded Hour (12hr)) 带0的时, 12小时制 |
H | 0~23 (0 padded Hour (24hr)) 带0的时, 24小时制 |
k | 1~24 (0 padded Hour (24hr) 带0的时, 24小时制 |
K | 0~11 (0 padded Hour (12hr)) 带0的时, 12小时制 |
L/LL | 1~12 (0 padded Month) 第几月 |
LLL | Jan/Feb/Mar/Apr/May/Jun/Jul/Aug/Sep/Oct/Nov/Dec 月份简写 |
LLLL | January/February/March/April/May/June/July/August/September/October/November/December 月份全称 |
m | 0~59 (0 padded Minute) 分钟 |
M/MM | 1~12 (0 padded Month) 第几月 |
MMM | Jan/Feb/Mar/Apr/May/Jun/Jul/Aug/Sep/Oct/Nov/Dec |
MMMM | January/February/March/April/May/June/July/August/September/October/November/December |
q/qq | 1~4 (0 padded Quarter) 第几季度 |
qqq | Q1/Q2/Q3/Q4 季度简写 |
qqqq | 1st quarter/2nd quarter/3rd quarter/4th quarter 季度全拼 |
Q/QQ | 1~4 (0 padded Quarter) 同小写 |
QQQ | Q1/Q2/Q3/Q4 同小写 |
QQQQ | 1st quarter/2nd quarter/3rd quarter/4th quarter 同小写 |
s | 0~59 (0 padded Second) 秒数 |
S | (rounded Sub-Second) 未知 |
u | (0 padded Year) 未知 |
v~vvv | (General GMT Timezone Abbreviation) 常规GMT时区的编写 |
vvvv | (General GMT Timezone Name) 常规GMT时区的名称 |
w | 1~53 (0 padded Week of Year, 1st day of week = Sunday, NB: 1st week of year starts from the last Sunday of last year) 一年的第几周, 一周的开始为周日,第一周从去年的最后一个周日起算 |
W | 1~5 (0 padded Week of Month, 1st day of week = Sunday) 一个月的第几周 |
y/yyyy | (Full Year) 完整的年份 |
yy/yyy | (2 Digits Year) 2个数字的年份 |
Y/YYYY | (Full Year, starting from the Sunday of the 1st week of year) 这个年份未知干嘛用的 |
YY/YYY | (2 Digits Year, starting from the Sunday of the 1st week of year) 这个年份未知干嘛用的 |
z~zzz | (Specific GMT Timezone Abbreviation) 指定GMT时区的编写 |
zzzz | (Specific GMT Timezone Name) Z: +0000 (RFC 822 Timezone) 指定GMT时区的名称 |
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];
// 2017年8月03日 星期四 下午9:00:09
NSLog(@"locale & template date: %@", localeTemplateString);
@"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];
}
// 2017/8/4 下午3:05 (所处时区不同,最终显示的时间结果也会不同。)
NSLog(@"user visible date time string: %@", userVisibleDateTimeString);
这里的关键是,dateFromString:
的字符串参数和setDateFormat:
的字符串参数的格式要匹配。
NSDateFormatter
的常用功能介绍完毕。