國際化-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

審核編輯 黃宇