Intl开发指导


Intl开发指导

Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方法。

设置区域信息

调用Locale的相关接口实现最大化区域信息或最小化区域信息。

接口说明

模块 接口名称 描述
ohos.intl constructor()8+ 实例化Locale对象。
ohos.intl constructor(locale: string, options?: LocaleOptions) 基于locale参数及其选项实例化Locale对象。
ohos.intl toString(): string 将Locale信息转换为字符串。
ohos.intl maximize(): Locale 最大化区域信息。
ohos.intl minimize(): Locale 最小化区域信息。

开发步骤

  1. 实例化Locale对象 使用Locale的构造函数创建Locale对象,该方法接收一个表示Locale的字符串及可选的属性列表(intl为导入的模块名)。

    var locale = "zh-CN";
    var options = {caseFirst: false, calendar: "chinese", collation: pinyin};
    var localeObj = new intl.Locale(locale, options);
    
    1
    2
    3
  2. 获取Locale的字符串表示 调用toString方法来获取Locale对象的字符串表示,其中包括了语言、区域及其他选项信息。

    var localeStr = localeObj.toString();
    
    1
  3. 最大化区域信息 调用maximize方法来最大化区域信息,即当缺少脚本与地区信息时,对其进行补全。

    var maximizedLocale = localeObj.maximize();
    
    1
  4. 最小化区域信息 调用minimize方法来最小化区域信息,即当存在脚本与地区信息时,对其进行删除。

    var minimizedLocale = localeObj.minimize();
    
    1

格式化日期时间

调用日期时间格式化DateTimeFormat的接口,实现针对特定Locale的日期格式化以及时间段格式化功能。

接口说明

模块 接口名称 描述
ohos.intl constructor()8+ 创建日期时间格式化对象。
ohos.intl constructor(locale: string | Array<string>, options?: DateTimeOptions) 创建日期时间格式化对象,并设置提供的Locale和格式化相关属性。
ohos.intl format(date: Date): string 依据DateTimeFormat对象的Locale及其他格式化属性,计算日期时间的格式化表示。
ohos.intl formatRange(startDate: Date, endDate: Date): string 依据DateTimeFormat对象的Locale及其他格式化属性,计算时间段的格式化表示。
ohos.intl resolvedOptions(): DateTimeOptions 获取DateTimeFormat对象的相关属性。

开发步骤

  1. 实例化日期时间格式化对象 一种方法是使用DateTimeFormat提供的默认构造函数,通过访问系统语言和地区设置,获取系统默认Locale,并将其作为DateTimeFormat对象内部的Locale(intl为导入的模块名)。

    var dateTimeFormat = new intl.DateTimeFormat();
    
    1

    另一种方法是使用开发者提供的Locale和格式化参数来创建日期时间格式化对象。其中,格式化参数是可选的,完整的格式化参数列表见DateTimeOptions

    var options = {dateStyle: "full", timeStyle: "full"};
    var dateTimeFormat = new intl.DateTimeFormat("zh-CN", options);
    
    1
    2
  2. 格式化日期时间 使用DateTimeFormat的format方法对一个Date对象进行格式化,该方法会返回一个字符串作为格式化的结果。

    Date date = new Date();
    var formatResult = dateTimeFormat.format(date);
    
    1
    2
  3. 格式化时间段 使用DateTimeFormat的formatRange方法对一个时间段进行格式化。该方法需要传入两个Date对象,分别表示时间段的起止时间,返回一个字符串作为格式化的结果。

    Date startDate = new Date();
    Date endDate = new Date();
    var formatResult = dateTimeFormat.formatRange(startDate, endDate);
    
    1
    2
    3
  4. 访问日期时间格式化对象的相关属性 DateTimeFormat的resolvedOptions方法会返回一个对象,该对象包含了DateTimeFormat对象的所有相关属性及其值。

    var options = dateTimeFormat.resolvedOptions();
    
    1

数字格式化

调用数字格式化NumberFormat的接口,实现针对特定Locale的数字格式化功能。

接口说明

模块 接口名称 描述
ohos.intl constructor()8+ 创建数字格式化对象。
ohos.intl constructor(locale: string | Array<string>, options?: NumberOptions) 创建数字格式化对象,并设置提供的locale和格式化相关属性。
ohos.intl format(number: number): string 依据NumberFormat对象的Locale及其他格式化属性,计算数字的格式化表示。
ohos.intl resolvedOptions(): NumberOptions 获取NumberFormat对象的相关属性。

开发步骤

  1. 实例化数字格式化对象 一种方法是使用NumberFormat提供的默认构造函数,通过访问系统的语言和地区以获取系统默认Locale并进行设置(intl为导入的模块名)。

    var numberFormat = new intl.NumberFormat();
    
    1

    另一种方法是使用开发者提供的Locale和格式化参数来创建数字格式化对象。其中,格式化参数是可选的,完整的格式化参数列表参见NumberOptions

    var options = {compactDisplay: "short", notation: "compact"};
    var numberFormat = new intl.NumberFormat("zh-CN", options);
    
    1
    2
  2. 数字格式化 使用NumberFormat的format方法对传入的数字进行格式化。该方法返回一个字符串作为格式化的结果。

    var number = 1234.5678
    var formatResult = numberFormat.format(number);
    
    1
    2
  3. 访问数字格式化对象的相关属性 NumberFormat的resolvedOptions方法会返回一个对象,该对象包含了NumberFormat对象的所有相关属性及其值。

    var options = numberFormat.resolvedOptions();
    
    1

字符串排序

不同区域的用户对于字符串排序具有不同的需求。调用字符串排序Collator的接口,实现针对特定Locale的字符串排序功能。

接口说明

模块 接口名称 描述
ohos.intl constructor()8+ 创建排序对象。
ohos.intl constructor(locale: string | Array<string>, options?: CollatorOptions)8+ 创建排序对象,并设置提供的locale和其他相关属性。
ohos.intl compare(first: string, second: string): number8+ 依据排序对象的Locale及其属性,计算两个字符串的比较结果。
ohos.intl resolvedOptions(): CollatorOptions8+ 获取排序对象的相关属性。

开发步骤

  1. 实例化排序对象 一种方法是使用Collator提供的默认构造函数,通过访问系统的语言和地区以获取系统默认Locale并进行设置(intl为导入的模块名)。

    var collator = new intl.Collator();
    
    1

    另一种方法是使用开发者提供的Locale和其他相关参数来创建Collator对象,完整的参数列表参见CollatorOptions

    var collator= new intl.Collator("zh-CN", {localeMatcher: "best fit", usage: "sort"};
    
    1
  2. 比较字符串 使用Collator的compare方法对传入的两个字符串进行比较。该方法返回一个数值作为比较的结果,返回-1表示第一个字符串小于第二个字符串,返回1表示第一个字符大于第二个字符串,返回0表示两个字符串相同。

    var str1 = "first string";
    var str2 = "second string";
    var compareResult = collator.compare(str1, str2);
    
    1
    2
    3
  3. 访问排序对象的相关属性 Collator的resolvedOptions方法会返回一个对象,该对象包含了Collator对象的所有相关属性及其值。

    var options = collator.resolvedOptions();
    
    1

判定单复数类别

在一些语言的语法中,当数字后面存在名词时,名词需要根据数字的值采用不同的形式。调用单复数PluralRules的接口,可以实现针对特定Locale计算数字单复数类别的功能,从而选择合适的名词单复数表示。

接口说明

模块 接口名称 描述
ohos.intl constructor()8+ 创建单复数对象。
ohos.intl constructor(locale: string | Array<string>, options?: PluralRulesOptions)8+ 创建单复数对象,并设置提供的locale和其他相关属性。
ohos.intl select(n: number): string8+ 依据单复数对象的Locale及其他格式化属性,计算数字的单复数类别。

开发步骤

  1. 实例化单复数对象 一种方法是使用PluralRules提供的默认构造函数,通过访问系统的语言和地区以获取系统默认Locale并进行设置(intl为导入的模块名)。

    var pluralRules = new intl.PluralRules();
    
    1

    另一种方法是使用开发者提供的Locale和其他相关参数来创建单复数对象,完整的参数列表参见PluralRulesOptions

    var plurals = new intl.PluralRules("zh-CN", {localeMatcher: "best fit", type: "cardinal"};
    
    1
  2. 计算数字单复数类别 使用PluralRules的select方法计算传入数字的单复数类别。该方法返回一个字符串作为传入数字的类别,包括:"zero", "one", "two", "few", "many", "other"六个类别。

    var number = 1234.5678
    var categoryResult = plurals.select(number);
    
    1
    2

相对时间格式化

调用相对时间格式化RelativeTimeFormat的接口,实现针对特定Locale的相对时间格式化功能。

接口说明

模块 接口名称 描述
ohos.intl constructor()8+ 创建相对时间格式化对象。
ohos.intl constructor(locale: string | Array<string>, options?: RelativeTimeFormatInputOptions)8+ 创建相对时间格式化对象,并设置提供的locale和格式化相关属性。
ohos.intl format(value: number, unit: string): string8+ 依据相对时间格式化对象的Locale及其他格式化属性,计算相对时间的格式化表示。
ohos.intl formatToParts(value: number, unit: string): Array<object>8+ 依据相对时间格式化对象的Locale及其他格式化属性,返回相对时间格式化表示的各个部分。
ohos.intl resolvedOptions(): RelativeTimeFormatResolvedOptions8+ 获取相对时间格式化对象的相关属性。

开发步骤

  1. 实例化相对时间格式化对象 一种方法是使用RelativeTimeFormat提供的默认构造函数,通过访问系统的语言和地区以获取系统默认Locale并进行设置(intl为导入的模块名)。

    var relativeTimeFormat = new intl.RelativeTimeFormat();
    
    1

    另一种方法是使用开发者提供的Locale和格式化参数来创建相对时间格式化对象。其中,格式化参数是可选的,完整的参数列表参见 RelativeTimeFormatInputOptions

    var relativeTimeFormat = new intl.RelativeTimeFormat("zh-CN", {numeric: "always", style: "long"};
    
    1
  2. 相对时间格式化 使用RelativeTimeFormat的format方法对相对时间进行格式化。方法接收一个表示相对时间长度的数值和表示单位的字符串,其中单位包括:"year", "quarter", "month", "week", "day", "hour", "minute", "second"。方法返回一个字符串作为格式化的结果。

    var number = 2;
    var unit = "year"
    var formatResult = relativeTimeFormat.format(number, unit);
    
    1
    2
    3
  3. 获取相对时间格式化结果的各个部分 获取相对时间格式化结果的各个部分,从而自定义格式化结果。

    var number = 2;
    var unit = "year"
    var formatResult = relativeTimeFormat.formatToParts(number, unit);
    
    1
    2
    3
  4. 访问相对时间格式化对象的相关属性 RelativeTimeFormat的resolvedOptions方法会返回一个对象,该对象包含了RelativeTimeFormat对象的所有相关属性及其值,完整的属性列表参见 RelativeTimeFormatResolvedOptions

    var options = numberFormat.resolvedOptions();
    
    1

相关实例

针对Intl开发,有以下相关实例可供参考:

-International:国际化(JS)(API8)