数字与度量衡国际化

使用场景

在不同的国家和文化中，数字、货币和度量衡的表示方法有所不同，包括什么符号作为小数分隔符、分隔符后显示几位数字、使用什么样的货币和度量衡单位等。例如，开发者需要在应用界面显示数字“1,000”（一千），用于表示一件商品的价格。若采用固定格式“1,000”，由于在欧洲某些国家（如德国）使用逗号表示小数点，用户会理解为“1”。为了使界面呈现格式符合当地人的使用习惯，需要对数字、货币和度量衡进行格式化，格式化后会根据用户当前设置的语言和地区进行显示。

开发步骤

数字格式化

数字格式化通过NumberFormat的format接口实现，具体开发步骤如下。

  1. 导入模块。

    import Intl from '@ohos.intl';

  2. 创建NumberFormat对象。 传入locale列表时，使用第一个有效的locale创建对象。不传入locale参数时，使用系统当前的locale创建对象。 构造函数支持通过NumberOptions设置不同的数字格式化格式，具体请参考表1-表8。

    let numberFormat: Intl.NumberFormat = new Intl.NumberFormat(locale: string | Array<string>, options?: NumberOptions);

  3. 数字格式化，根据numberFormat的设置格式化number。

    let formattedNumber: string = numberFormat.format(number: number);

  4. 获取数字格式化选项，查看对象的设置信息。

    let options: Intl.NumberOptions = formattedNumber.resolvedOptions();

数字格式化选项

对于数字，通过NumberOptions参数可以设置最小整数位数、最小小数位数、最大小数位数、最低有效位数、最大有效位数、是否分组显示、数字的格式化规格、紧凑型的显示格式，以及数字的显示格式和数字系统。其中，数字的显示格式包括decimal(十进制)、percent(百分数)、currency(货币)、unit(单位)。

以123000.123为例，各属性参数取值和显示效果如下表所示。

表1 最小整数位数(minimumIntegerDigits)

取值 显示效果
6 123,000.123
7 0,123,000.123

表2 最小小数位数(minimumFractionDigits)

取值 显示效果
3 123,000.123
4 123,000.1230

表3 最大小数位数(maximumFractionDigits)

取值 显示效果
3 123,000.123
2 123,000.12

表4 最低有效位数(minimumSignificantDigits)

取值 显示效果
9 123,000.123
10 123,000.1230

表5 最大有效位数(maximumSignificantDigits)

取值 显示效果
9 123,000.123
8 123,000.12

表6 是否分组显示(useGrouping)

取值 显示效果
true 123,000.123
false 123000.123

表7 数字的格式化规格(notation)

取值 显示效果
standard 123,000.123
scientific 1.230001E5
engineering 123.000123E3
compact 123K

表8 紧凑型的显示格式(compactDisplay)

取值 显示效果
short 123K
long 123 thousand

开发实例

// 导入模块
import Intl from '@ohos.intl'

// 用科学计数法显示数字
let numberFormat1 = new Intl.NumberFormat('zh-CN', {notation: 'scientific', maximumSignificantDigits: 3});
let formattedNumber1 = numberFormat1.format(123400); // formattedNumber1: 1.23E5

// 用紧凑的格式显示数字
let numberFormat2 = new Intl.NumberFormat('zh-CN', {notation: 'compact', compactDisplay: 'short'});
let formattedNumber2 = numberFormat2.format(123400); // formattedNumber2: 12万

// 显示数字的符号
let numberFormat3 = new Intl.NumberFormat('zh-CN', {signDisplay: 'always'});
let formattedNumber3 = numberFormat3.format(123400); // formattedNumber3: +123,400

// 显示百分数
let numberFormat4 = new Intl.NumberFormat('zh-CN', {style: 'percent'});
let formattedNumber4 = numberFormat4.format(0.25); // formattedNumber4: 25%

货币和单位格式化

货币和单位的格式化基于数字格式化，在创建货币和单元格式化对象时，将数字的显示风格分别设置为“currency(货币)”和“unit(单位)”。同样，货币和单位的构造函数也支持通过NumberOptions设置不同的格式，各属性参数取值和显示效果如下表所示。

货币格式化选项

以货币单位: USD，数值: -12300为例。

表9 货币单位的符号(currencySign)

取值 显示效果
standard -US$12,300.00
accounting (US$12,300.00)

表10 货币的显示方式(currencyDisplay)

取值 显示效果
symbol -US$12,300.00
narrowSymbol -$12,300.00
code -USD 12,300.00
name -12,300.00 US dollars

单位格式化选项

以单位名称：hectare，数字大小：-12300为例。

表11 单位的显示格式(unitDisplay)

取值 显示效果
long -12,3000 hectares
short -12,300 ha
narrow -12,300ha

表12 单位的使用场景(unitUsage)

取值 显示效果
不设置 -12,300 ha
default -47.491 sq mi
area-land-agricult -30,393.962 ac

开发实例

// 导入模块
import Intl from '@ohos.intl'

// 格式化货币
let numberFormat5 = new Intl.NumberFormat('zh-CN', {style: 'currency', currency: 'USD'});
let formattedNumber5 = numberFormat5.format(123400); // formattedNumber5: US$123,400.00

// 用名称表示货币
let numberFormat6 = new Intl.NumberFormat('zh-CN', {style: 'currency', currency: 'USD', currencyDisplay: 'name'});
let formattedNumber6 = numberFormat6.format(123400); // formattedNumber6: 123,400.00美元

// 格式化度量衡
let numberFormat7 = new Intl.NumberFormat('en-GB', {style: 'unit', unit: 'hectare'});
let formattedNumber7 = numberFormat7.format(123400); // formattedNumber7: 123,400 ha

// 格式化特定场景下度量衡，如面积-土地-农业
let numberFormat8 = new Intl.NumberFormat('en-GB', {style: 'unit', unit: 'hectare', unitUsage: 'area-land-agricult'});
let formattedNumber8 = numberFormat8.format(123400); // formattedNumber8: 304,928.041 ac

度量衡转换

单位转换并根据区域和风格进行格式化，通过I18NUtil类的unitConvert接口实现，具体开发步骤如下。

  1. 导入模块。

    import I18n from '@ohos.i18n';

  2. 度量衡转换。

    将度量衡从fromUnit转换到toUnit，数值为value，并根据区域和风格进行格式化。style可取不同的值，显示不用效果，具体请参考表13。

    let convertedUnit: string = I18n.I18NUtil.unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale: string, style?: string);

格式化风格

以fromUnit为美制单位cup，toUnit为公制单位liter，数字大小：1000为例。

表13 格式化使用的风格(style)

取值 显示效果
long 236.588 liters
short 236.588 L
narrow 236.588L

开发实例

// 导入模块
import I18n from '@ohos.i18n'

// 设置要转换的单位和目标单位
let fromUnit: I18n.UnitInfo = {unit: 'cup', measureSystem: 'US'};
let toUnit: I18n.UnitInfo = {unit: 'liter', measureSystem: 'SI'};

// 以en-US区域参数转换度量衡
let convertedUnit1 = I18n.I18NUtil.unitConvert(fromUnit, toUnit, 1000, 'en-US'); // convertedUnit1: 236.588 L

// 显示完整的度量衡
let convertedUnit2 = I18n.I18NUtil.unitConvert(fromUnit, toUnit, 1000, 'en-US', 'long'); // convertedUnit2: 236.588 liters