NSDateFormatter



分类: iOS平台


前言:iOS开发中NSDateFormatter是一个很常用的类,用于格式化NSDate对象,支持本地化的信息。与时间相关的功能还可能会用到 NSDateComponents类和NSCalendar类等。本文主要列出NSDateFormatter常见用法。



 NSDate对象包含两个部分,日期(Date)和时间(Time)。格式化的时间字符串主要也是针对日期和时间的。[以下代码中开启了ARC,所以没有release。]

1、基础用法


  1. NSDate* now = [NSDate date];
  2. NSDateFormatter* fmt = [[NSDateFormatter alloc] init];
  3. fmt.dateStyle = kCFDateFormatterShortStyle;
  4. fmt.timeStyle = kCFDateFormatterShortStyle;
  5. fmt.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US"];
  6. NSString* dateString = [fmt stringFromDate:now];
  7. NSLog(@"%@", dateString);


打印输出:10/29/12, 2:27 PM

这使用的系统提供的格式化字符串,通过 fmt.dateStyle 和 fmt.timeStyle 进行的设置。实例中使用的参数是 kCFDateFormatterShortStyle,此外还有:



  1. typedef CF_ENUM(CFIndex, CFDateFormatterStyle) { // date and time format styles
  2.     kCFDateFormatterNoStyle = 0, // 无输出
  3.     kCFDateFormatterShortStyle = 1, // 10/29/12, 2:27 PM
  4.     kCFDateFormatterMediumStyle = 2, // Oct 29, 2012, 2:36:59 PM
  5.     kCFDateFormatterLongStyle = 3, // October 29, 2012, 2:38:46 PM GMT+08:00
  6.     kCFDateFormatterFullStyle = 4 // Monday, October 29, 2012, 2:39:56 PM China Standard Time
  7. };


2. 自定义区域语言如上实例中,我们使用的是区域语言是 en_US,指的是美国英语。如果我们换成简体中文,则代码是:



1 fmt.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"zh_CN"];


 则对应的输出为:



  1. typedef CF_ENUM(CFIndex, CFDateFormatterStyle) { // date and time format styles
  2.     kCFDateFormatterNoStyle = 0, // 无输出
  3.     kCFDateFormatterShortStyle = 1, // 12-10-29 下午2:52
  4.     kCFDateFormatterMediumStyle = 2, // 2012-10-29 下午2:51:43
  5.     kCFDateFormatterLongStyle = 3, // 2012年10月29日 GMT+0800下午2时51分08秒
  6.     kCFDateFormatterFullStyle = 4 // 2012年10月29日星期一 中国标准时间下午2时46分49秒
  7. };


世界通用的区域语言代码,详见 International Components for Unicode (ICU),  ​​http://userguide.icu-project.org/formatparse/datetime​

3. 自定义日期时间格式NSDateFormatter提供了自定义日期时间的方法,主要是通过设置属性 dateFormat,常见的设置如下:



  1. NSDate* now = [NSDate date];
  2. NSDateFormatter* fmt = [[NSDateFormatter alloc] init];
  3. fmt.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"zh_CN"];
  4. fmt.dateFormat = @"yyyy-MM-dd'T'HH:mm:ss";
  5. NSString* dateString = [fmt stringFromDate:now];
  6. NSLog(@"%@", dateString);


打印输出:2012-10-29T16:08:40

除了上面列出的,还可以指定很多格式,详见​​http://userguide.icu-project.org/formatparse/datetime​​。

结合设置Locale,还可以打印出本地化的字符串信息。



  1. NSDate* now = [NSDate date];
  2. NSDateFormatter* fmt = [[NSDateFormatter alloc] init];
  3. fmt.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"zh_CN"];
  4. fmt.dateFormat = @"yyyy-MM-dd a HH:mm:ss EEEE";
  5. NSString* dateString = [fmt stringFromDate:now];
  6. NSLog(@"\n%@", dateString);


打印输出:2012-10-29 下午 16:25:27 星期一

4. 自定义月份星期等字符NSDateFormatter中同样提供了相应的方式,去修改这些字符。一般情况下,使用相应区域语言下面的默认字符就OK了。但是你的确有这个需求,那么也是可以办到的。相应的方法非常多,如下:

Managing AM and PM Symbols

  • – AMSymbol
  • – setAMSymbol:
  • – PMSymbol
  • – setPMSymbol:

Managing Weekday Symbols

  • – weekdaySymbols
  • – setWeekdaySymbols:
  • – shortWeekdaySymbols
  • – setShortWeekdaySymbols:
  • – veryShortWeekdaySymbols
  • – setVeryShortWeekdaySymbols:
  • – standaloneWeekdaySymbols
  • – setStandaloneWeekdaySymbols:
  • – shortStandaloneWeekdaySymbols
  • – setShortStandaloneWeekdaySymbols:
  • – veryShortStandaloneWeekdaySymbols
  • – setVeryShortStandaloneWeekdaySymbols:

Managing Month Symbols

  • – monthSymbols
  • – setMonthSymbols:
  • – shortMonthSymbols
  • – setShortMonthSymbols:
  • – veryShortMonthSymbols
  • – setVeryShortMonthSymbols:
  • – standaloneMonthSymbols
  • – setStandaloneMonthSymbols:
  • – shortStandaloneMonthSymbols
  • – setShortStandaloneMonthSymbols:
  • – veryShortStandaloneMonthSymbols
  • – setVeryShortStandaloneMonthSymbols:

Managing Quarter Symbols

  • – quarterSymbols
  • – setQuarterSymbols:
  • – shortQuarterSymbols
  • – setShortQuarterSymbols:
  • – standaloneQuarterSymbols
  • – setStandaloneQuarterSymbols:
  • – shortStandaloneQuarterSymbols
  • – setShortStandaloneQuarterSymbols:

Managing Era Symbols

  • – eraSymbols
  • – setEraSymbols:
  • – longEraSymbols
  • – setLongEraSymbols: