国际化-Intl

说明：
开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

• 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
• Intl模块包含国际化能力基础接口（在ECMA 402中定义）。

导入模块

import Intl from '@ohos.intl';

Locale

属性

系统能力 ：以下各项对应的系统能力均为SystemCapability.Global.I18n

constructor8+

constructor()

创建区域对象

系统能力 ：SystemCapability.Global.I18n

示例：

var locale = new Intl.Locale();

constructor

constructor(locale: string, options?: LocaleOptions)

创建区域对象

系统能力 ：SystemCapability.Global.I18n

参数：

示例：

var locale = new Intl.Locale("zh-CN");

toString

toString(): string

将区域信息转换为字符串

系统能力 ：SystemCapability.Global.I18n

返回值：

示例：

var locale = new Intl.Locale("zh-CN");
locale.toString();

maximize

maximize(): Locale

最大化区域信息，若缺少脚本与地区信息，则补齐。

系统能力 ：SystemCapability.Global.I18n

返回值：

示例：

var locale = new Intl.Locale("zh-CN");
locale.maximize();

minimize

minimize(): Locale

最小化区域信息，若包含脚本与地区信息，则去除。

系统能力 ：SystemCapability.Global.I18n

返回值：

示例：

var locale = new Intl.Locale("zh-CN");
locale.minimize();

LocaleOptions

表示区域初始化选项。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Global.I18n

DateTimeFormat

constructor8+

constructor()

创建时间日期格式化对象。

系统能力 ：SystemCapability.Global.I18n

示例：

var datefmt= new Intl.DateTimeFormat();

constructor

constructor(locale: string | Array, options?: DateTimeOptions)

创建时间日期格式化对象。

系统能力 ：SystemCapability.Global.I18n

参数：

示例：

var datefmt= new Intl.DateTimeFormat("zh-CN", { dateStyle: 'full', timeStyle: 'medium' });

示例：

var datefmt= new Intl.DateTimeFormat(["ban", "zh"], { dateStyle: 'full', timeStyle: 'medium' });

format

format(date: Date): string

格式化时间日期字符串。

系统能力 ：SystemCapability.Global.I18n

参数：

返回值：

示例：

var date = new Date(2021, 11, 17, 3, 24, 0);
var datefmt = new Intl.DateTimeFormat("en-GB");
datefmt.format(date);

formatRange

formatRange(startDate: Date, endDate: Date): string

格式化时间日期段字符串。

系统能力 ：SystemCapability.Global.I18n

参数：

返回值：

示例：

var startDate = new Date(2021, 11, 17, 3, 24, 0);
var endDate = new Date(2021, 11, 18, 3, 24, 0);
var datefmt = new Intl.DateTimeFormat("en-GB");
datefmt.formatRange(startDate, endDate);

resolvedOptions

resolvedOptions(): DateTimeOptions

获取DateTimeFormat对象的格式化选项。

系统能力 ：SystemCapability.Global.I18n

返回值：

示例：

var datefmt = new Intl.DateTimeFormat("en-GB");
datefmt.resolvedOptions();

DateTimeOptions

表示时间日期格式化选项。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Global.I18n

NumberFormat

constructor8+

constructor()

创建数字格式化对象。

系统能力 ：SystemCapability.Global.I18n

示例：

var numfmt = new Intl.NumberFormat();

constructor

constructor(locale: string | Array, options?: NumberOptions)

创建数字格式化对象。

系统能力 ：SystemCapability.Global.I18n

参数：

示例：

var numfmt = new Intl.NumberFormat("en-GB", {style:'decimal', notation:"scientific"});

format

format(number: number): string;

格式化数字字符串。

系统能力 ：SystemCapability.Global.I18n

参数：

返回值：

示例：

var numfmt = new Intl.NumberFormat(["en-GB", "zh"], {style:'decimal', notation:"scientific"});
numfmt.format(1223);

resolvedOptions

resolvedOptions(): NumberOptions

获取NumberFormat 对象的格式化选项。

系统能力 ：SystemCapability.Global.I18n

返回值：

示例：

var numfmt = new Intl.NumberFormat(["en-GB", "zh"], {style:'decimal', notation:"scientific"});
numfmt.resolvedOptions();

NumberOptions

表示设备支持的能力。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Global.I18n

Collator8+

constructor8+

constructor()

创建排序对象。

系统能力 ：SystemCapability.Global.I18n

示例：

var collator = new Intl.Collator();

constructor8+

constructor(locale: string | Array, options?: CollatorOptions)

创建排序对象。

系统能力 ：SystemCapability.Global.I18n

参数：

示例：

var collator = new Intl.Collator("zh-CN", {localeMatcher: "lookup", usage: "sort"});

compare8+

compare(first: string, second: string): number

依据Collator的排序策略对两个字符串进行比较。

系统能力 ：SystemCapability.Global.I18n

参数：

返回值：

示例：

var collator = new Intl.Collator("zh-Hans");
collator.compare("first", "second");

resolvedOptions8+

resolvedOptions(): CollatorOptions

返回Collator对象的属性。

系统能力 ：SystemCapability.Global.I18n

返回值：

示例：

var collator = new Intl.Collator("zh-Hans");
var options = collator.resolvedOptions();

CollatorOptions8+[]()

表示Collator可设置的属性。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Global.I18n

PluralRules8+

constructor8+

constructor()

创建PluralRules对象。

系统能力 ：SystemCapability.Global.I18n

示例：

var pluralRules = new Intl.PluralRules();

constructor8+

constructor(locale: string | Array, options?: PluralRulesOptions)

创建PluralRules对象。

系统能力 ：SystemCapability.Global.I18n

参数：

示例：

var pluralRules= new Intl.PluraRules("zh-CN", {"localeMatcher": "lookup", "type": "cardinal"});

select8+

select(n: number): string

返回一个字符串表示该数字的单复数类别。

系统能力 ：SystemCapability.Global.I18n

参数：

返回值：

示例：

var pluralRules = new Intl.PluralRules("zh-Hans");
pluralRules.select(1);

PluralRulesOptions8+[]()

表示PluralRules对象可设置的属性。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Global.I18n

RelativeTimeFormat8+

constructor8+

constructor()

创建相对时间格式化对象。

系统能力 ：SystemCapability.Global.I18n

示例：

var relativetimefmt = new Intl.RelativeTimeFormat();

constructor8+

constructor(locale: string | Array, options?: RelativeTimeFormatInputOptions)

创建相对时间格式化对象。

系统能力 ：SystemCapability.Global.I18n

参数：

示例：

var relativeTimeFormat = new Intl.RelativeTimeFormat("zh-CN", {"localeMatcher": "lookup", "numeric": "always", "style": "long"});

format8+

format(value: number, unit: string): string

依据locale和格式化选项，对value和unit进行格式化。

系统能力 ：SystemCapability.Global.I18n

参数：

返回值：

示例：

var relativetimefmt = new Intl.RelativeTimeFormat("zh-CN");
relativetimefmt.format(3, "quarter")

formatToParts8+

formatToParts(value: number, unit: string): Array

返回一个对象数组，表示可用于自定义区域设置格式的相对时间格式。

系统能力 ：SystemCapability.Global.I18n

参数：

返回值：

示例：

var relativetimefmt = new Intl.RelativeTimeFormat("en", {"numeric": "auto"});
var parts = relativetimefmt.format(10, "seconds");

resolvedOptions8+

resolvedOptions(): RelativeTimeFormatResolvedOptions

获取RelativeTimeFormat对象的格式化选项。

系统能力 ：SystemCapability.Global.I18n

返回值：

示例：

var relativetimefmt= new Intl.RelativeTimeFormat("en-GB");
relativetimefmt.resolvedOptions();

RelativeTimeFormatInputOptions8+[]()

表示RelativeTimeFormat对象可设置的属性。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Global.I18n

RelativeTimeFormatResolvedOptions8+[]()

表示RelativeTimeFormat对象可设置的属性。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Global.I18n

审核编辑 黄宇