NSNumberFormatter提供两个方便方法,stringFromNumber: 和 numberFromString:,前者你用以创建数字的字符串表示法,后者用以创建来自字符串的数字对象。想要在不创建格式化器对象的情况下创建数字的本地化的字符串表示法,你可以使用类方法localizedStringFromNumber:numerStyle:。
如果你在解析字符串的时候有更加复杂的要求,除了使用继承自NSFormatter的方法之外,getObjectValue:forString:range:error:方法允许你指定被解析字符串的子串,并且返回真实解析了字符串范围。(在出错的情况下,它指明错误发生的位置。)它还返回NSError对象,它包含关于错误的丰富信息。
数字格式化器有多个属性可以读写。当你把信息显示给用户的时候,你通常应该使用NSNumberFormatter样式常量,这些常量预定义了一组决定格式化数据如何显示的属性。但是,如果你需要以精确的格式生成数字的表示法,你应该使用格式字符串。
使用格式化器样式来呈现用户偏好的数字
NSNumberFormatter可以让你很容易的使用用户配置在系统偏好的“国际偏好”面板中的设置来格式化不同的数字分类。NSNumberFormatter样式常量——NSNumberFormatterDecimalStyle, NSNumberFormatterCurrencyStyle, NSNumberFormatterPercentStyle, NSNumberFormatterScientificStyle, 或 NSNumberFormatterSpellOutStyle(它生成一个数字的原文表示法)——指定一组属性,它们依据用户的偏好来确定如何显示数字。
你可以使用setNumberStyle:方法来指定数字格式化器的样式。代码清单1演示了你可以使用格式化器样式格式化日期。
代码清单 1 使用格式化器样式格式化数字
NSNumberFormatter *numberFormatter = [[NSNumberFormatter alloc] init];
[numberFormatter setNumberStyle:NSNumberFormatterDecimalStyle];
NSString *formattedNumberString = [numberFormatter stringFromNumber:@122344.4563];
NSLog(@"formattedNumberString: %@", formattedNumberString);
// Output for locale en_US: "formattedNumberString: formattedNumberString: 122,344.453"
使用格式字符串来指定自定义格式
格式字符串使用来自Unicode Technical Standard #35的格式模式。不同的操作系统版本使用不同标准的版本:
- OS X v10.9 和 iOS 7 使用 version tr35-31.
- OS X v10.8 和 iOS 6 使用 version tr35-25.
- iOS 5 使用 version tr35-19.
- OS X v10.7 和 iOS 4.3 使用 version tr35-17.
- iOS 4.0, iOS 4.1, 和 iOS 4.2 使用 version tr35-15.
- iOS 3.2 使用 version tr35-12.
- OS X v10.6, iOS 3.0, 和 iOS 3.1 使用 version tr35-10.
- OS X v10.5 使用 version tr35-6.
- OS X v10.4 使用 version tr35-4.
注意Unicode格式字符串的格式,你应该在格式字符串中的字面量放在两个撇号之间('')。
你使用setPositiveFormat:和setNegativeFormat:方法来指定数字格式化器的格式字符串。代码清单2演示了你如何使用格式化器样式格式化一个日期。
代码清单 2 使用格式字符串格式化数字
NSNumberFormatter *numberFormatter = [[NSNumberFormatter alloc] init];
[numberFormatter setPositiveFormat:@"###0.##"];
NSString *formattedNumberString = [numberFormatter stringFromNumber:@122344.4563];
NSLog(@"formattedNumberString: %@", formattedNumberString);
// Output for locale en_US: "formattedNumberString: formattedNumberString: 122,344.45"
百分比
如果你使用带有“%”字符的格式字符串来格式化百分比,那结果可能会混乱。思考下面这个例子:
NSNumberFormatter *numberFormatter = [[NSNumberFormatter alloc] init];
[numberFormatter setPositiveFormat:@"0.00%"];
NSLog(@"%@", [numberFormatter stringFromNumber:@4.0]);
// Output: "400.00%".
因为格式字符串使用百分比来指定,所以NSNumberFormatter把数字4解释为一个分数(1就是100%),也就是4 = 4 / 1 = 400%。
如果你想以百分比来表现数字,你应该使用NSNumberFormatterPercentStyle样式,它还确保百分比适应于语言环境:
NSNumberFormatter *numberFormatter = [[NSNumberFormatter alloc] init];
[numberFormatter setNumberStyle:NSNumberFormatterPercentStyle];
NSLocale *usLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US"];
[numberFormatter setLocale:usLocale];
NSLog(@"en_US: %@", [numberFormatter stringFromNumber:@4.0]);
// Output: "en_US: 400%".
NSLocale *faLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"fa_IR"];
[numberFormatter setLocale:faLocale];
NSLog(@"fa_IR: %@", [numberFormatter stringFromNumber:@4.0]);
// Output: "fa_IR: ٪۴۰۰."
命名法
NSNumberFormatter提供多个方法(例如,setMaximumFractioinDigits:)允许你管理实例允许输入的小数位数。“小数”是小数操作符(在英语国家,小数操作符通常指的就是小数点)后面的数字。