NSFormatters使用

日期和数字是每个App必不可少的一个部分，作为一个合格的app应该能够以合理的格式显示数字，日期等等。由于不通地区，甚至不同场景下所需要的显示格式不一样，格式化这些数据还是比较复杂的。

幸运的是Cocoa框架很擅长于处理相关信息NSFormatter几乎能涵盖所有的转换需求。

iOS8在原来的NSNumberFormatter和NSDateFormatter基础上增加了一些新的日期、时间转换以及一些物理量相互转换的方法。

NSNumberFormatter

日常工作中经常需要打印出各类数字，其中很多都是高精度的Float或Double类型，但是对于我们$10.321 和 $10.321054823并没有多少实质性区别。所以这种时候就需要使用NSNumberFormatter

NSNumberFormatter包含一下几种样式

• NoStyle
• DecimalStyle
• CurrencyStyle
• PercentStyle
• ScientificStyle
• SpellOutStyle

其实这些名字都很好理解，下面就是运行结果

var num = 12345.6789098
let formatter = NSNumberFormatter()
formatter.numberStyle = .NoStyle
var result = formatter.stringFromNumber(num)
//12346

formatter.numberStyle = .DecimalStyle
result = formatter.stringFromNumber(num)
//12,345.679

formatter.numberStyle = .CurrencyStyle
result = formatter.stringFromNumber(num)
//$12,345.68

formatter.numberStyle = .PercentStyle
result = formatter.stringFromNumber(num)
//1,234,568%

formatter.numberStyle = .ScientificStyle
result = formatter.stringFromNumber(num)
//1.23456789098E4

formatter.numberStyle = .SpellOutStyle
result = formatter.stringFromNumber(num)
//twelve thousand three hundred forty-five point six seven eight nine zero nine eight

当然强大的NSNumberFormatter能做的不仅仅是这个，还可以利用以下四个属性指定输出位数

• var minimumIntegerDigits: Int
• var maximumIntegerDigits: Int
• var minimumFractionDigits: Int
• var maximumFractionDigits: Int

var num = 12345.6789098
let formatter = NSNumberFormatter()
formatter.maximumFractionDigits = 3
var result = formatter.stringFromNumber(num)
//12345.679

还可以自定义正负数的前后缀

var num = 12345.6789098
let formatter = NSNumberFormatter()
formatter.positivePrefix = "正前缀"
formatter.positiveSuffix = "正后缀"
var result = formatter.stringFromNumber(num)
///正前缀12345.679正后缀

更多参数可以通过Command + 点击的方式查看NSNumberFormatter属性来了解。

NSDateFormatter

日期格式化也是个常见需求NSDateFormatter内置一下几种格式

NSDateFormatterStyle	Date Out	Time Out
ShortStyle	12/25/14	7:00 AM
MediumStyle	Dec 25, 2014	7:00:00 AM”
LongStyle	December 25, 2014	7:00:00 AM PST
FullStyle	Thursday, December 25, 2014	7:00:00 AM Pacific Standard Time

用法

var date = NSDate(timeIntervalSinceNow: 0)
let formatter = NSDateFormatter()
formatter.dateStyle = .ShortStyle
formatter.timeStyle = .MediumStyle
var result = formatter.stringFromDate(date)

当然除了几种内置格式以外，还可以使用自定义格式，自定义格式比较多，详情参考Getting Started With NSNumberFormatter

新增Formatter

NSDateComponentsFormatter

NSDateComponentsFormatter允许格式化具体的某一向，比如12 days 13 hours and 12 minutes

let dateComponentsFormatter = NSDateComponentsFormatter()
let components = NSDateComponents()
components.hour   = 2
components.minute = 45

let dcfStyles: [NSDateComponentsFormatterUnitsStyle] =
    [.Positional, .Abbreviated, .Short, .Full, .SpellOut]

for style in dcfStyles {
  dateComponentsFormatter.unitsStyle = style
  dateComponentsFormatter.stringFromDateComponents(components)
}

Units Style	Result
.Positional	2:45
.Abbreviated	2h 45m
.Short	2 hrs, 45 mins
.Full	2 hours, 45 minutes
.SpellOut	two hours, forty-five minutes

当然还可以重写默认语言，按照指定语言输出

let calendar = NSCalendar.currentCalendar()
calendar.locale = NSLocale(localeIdentifier: "ug")
dateComponentsFormatter.unitsStyle = .Full
dateComponentsFormatter.calendar = calendar
dateComponentsFormatter.stringFromDateComponents(components)
//"2 سائەت and 45 مىنۇت"

NSDateIntervalFormatter

let dateIntervalFormatter = NSDateIntervalFormatter()
let now = NSDate()
let longTimeAgo = NSDate(timeIntervalSince1970: 0.0)
let difStyles: [NSDateIntervalFormatterStyle] =
  [.NoStyle, .ShortStyle, .MediumStyle, .LongStyle, .FullStyle]
for style in difStyles {
  dateIntervalFormatter.dateStyle = style
  dateIntervalFormatter.timeStyle = style
  dateIntervalFormatter.stringFromDate(longTimeAgo, toDate: now)
}

Style	Result
.NoStyle
.ShortStyle	1/1/70, 1:00 AM – 7/30/14, 9:32 AM
.MediumStyle	Jan 1, 1970, 1:00:00 AM – Jul 30, 2014, 9:32:35 AM
.LongStyle	January 1, 1970, 1:00:00 AM GMT+1 – July 30, 2014, 9:32:35 AM GMT+1
.FullStye	Thursday, January 1, 1970, 1:00:00 AM GMT+01:00 – Wednesday, July 30, 2014, 9:32:35 AM British Summer Time

其他

新特性还包括

• NSLengthFormatter
• NSMassFormatter
• NSEnergyFormatter

等，具体的用法可以参考iOS8 Day-by-Day :: Day 15 :: New NSFormatters

应用

下面是我写的简单一个时间格式化函数，把从服务器过去的时间戳与现在时间比较，然后显示恰当的格式。要求如下

与时间时间差	显示
小于60秒	刚刚
1小时	xx分钟前
小于1天	xx小时前
昨天	昨天 xx:xx
一年内时间	xx月xx日 HH:MM
其他显示	xx年xx月xx日 HH:MM

func getTimeString(timeStamp:String) -> String? {
  let timeInterval:NSTimeInterval = NSString(string: timeStamp).doubleValue
  let time = NSDate().timeIntervalSince1970
  if time - timeInterval < 60 {
    return "刚刚"
  }

  var min:Int = Int((time - timeInterval)/60)
  if min < 60 {
    return "\(min)分钟前"
  }

  var hour:Int = Int(min/60)
  if hour < 24 {
    return "\(hour)小时前"
  }

  let formatter = NSDateFormatter()

  if hour < 48 {
    formatter.dateFormat = "昨天 HH:MM"
  } else if hour < 24 * 365 {
    formatter.dateFormat = "M月d日 HH:MM"
  } else {
    formatter.dateFormat = "yyyy年M月d日 HH:MM"
  }

  let date = NSDate(timeIntervalSince1970: timeInterval)
  let dateStr = formatter.stringFromDate(date)
  return dateStr
}

参考

• Getting Started With NSNumberFormatter
• iOS8 Day-by-Day :: Day 15 :: New NSFormatters