國際化-Intl

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

• 本模塊首批接口從API version 6開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。
• Intl模塊包含國際化能力基礎(chǔ)接口（在ECMA 402中定義）。

導入模塊

import Intl from '@ohos.intl';

Locale

屬性

系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.Global.I18n

constructor8+

constructor()

創(chuàng)建區(qū)域?qū)ο?/p>

系統(tǒng)能力 ：SystemCapability.Global.I18n

示例：

var locale = new Intl.Locale();

constructor

constructor(locale: string, options?: LocaleOptions)

創(chuàng)建區(qū)域?qū)ο?/p>

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

示例：

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

toString

toString(): string

將區(qū)域信息轉(zhuǎn)換為字符串

系統(tǒng)能力 ：SystemCapability.Global.I18n

返回值：

示例：

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

maximize

maximize(): Locale

最大化區(qū)域信息，若缺少腳本與地區(qū)信息，則補齊。

系統(tǒng)能力 ：SystemCapability.Global.I18n

返回值：

示例：

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

minimize

minimize(): Locale

最小化區(qū)域信息，若包含腳本與地區(qū)信息，則去除。

系統(tǒng)能力 ：SystemCapability.Global.I18n

返回值：

示例：

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

LocaleOptions

表示區(qū)域初始化選項。

系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.Global.I18n

DateTimeFormat

constructor8+

constructor()

創(chuàng)建時間日期格式化對象。

系統(tǒng)能力 ：SystemCapability.Global.I18n

示例：

var datefmt= new Intl.DateTimeFormat();

constructor

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

創(chuàng)建時間日期格式化對象。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

示例：

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

格式化時間日期字符串。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

返回值：

示例：

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

格式化時間日期段字符串。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

返回值：

示例：

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對象的格式化選項。

系統(tǒng)能力 ：SystemCapability.Global.I18n

返回值：

示例：

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

DateTimeOptions

表示時間日期格式化選項。

系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.Global.I18n

NumberFormat

constructor8+

constructor()

創(chuàng)建數(shù)字格式化對象。

系統(tǒng)能力 ：SystemCapability.Global.I18n

示例：

var numfmt = new Intl.NumberFormat();

constructor

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

創(chuàng)建數(shù)字格式化對象。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

示例：

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

format

format(number: number): string;

格式化數(shù)字字符串。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

返回值：

示例：

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

resolvedOptions

resolvedOptions(): NumberOptions

獲取NumberFormat 對象的格式化選項。

系統(tǒng)能力 ：SystemCapability.Global.I18n

返回值：

示例：

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

NumberOptions

表示設備支持的能力。

系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.Global.I18n

Collator8+

constructor8+

constructor()

創(chuàng)建排序?qū)ο蟆?/p>

系統(tǒng)能力 ：SystemCapability.Global.I18n

示例：

var collator = new Intl.Collator();

constructor8+

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

創(chuàng)建排序?qū)ο蟆?/p>

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

示例：

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

compare8+

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

依據(jù)Collator的排序策略對兩個字符串進行比較。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

返回值：

示例：

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

resolvedOptions8+

resolvedOptions(): CollatorOptions

返回Collator對象的屬性。

系統(tǒng)能力 ：SystemCapability.Global.I18n

返回值：

示例：

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

CollatorOptions8+[]()

表示Collator可設置的屬性。

系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.Global.I18n

PluralRules8+

constructor8+

constructor()

創(chuàng)建PluralRules對象。

系統(tǒng)能力 ：SystemCapability.Global.I18n

示例：

var pluralRules = new Intl.PluralRules();

constructor8+

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

創(chuàng)建PluralRules對象。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

示例：

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

select8+

select(n: number): string

返回一個字符串表示該數(shù)字的單復數(shù)類別。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

返回值：

示例：

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

PluralRulesOptions8+[]()

表示PluralRules對象可設置的屬性。

系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.Global.I18n

RelativeTimeFormat8+

constructor8+

constructor()

創(chuàng)建相對時間格式化對象。

系統(tǒng)能力 ：SystemCapability.Global.I18n

示例：

var relativetimefmt = new Intl.RelativeTimeFormat();

constructor8+

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

創(chuàng)建相對時間格式化對象。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

示例：

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

format8+

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

依據(jù)locale和格式化選項，對value和unit進行格式化。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

返回值：

示例：

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

formatToParts8+

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

返回一個對象數(shù)組，表示可用于自定義區(qū)域設置格式的相對時間格式。

系統(tǒng)能力 ：SystemCapability.Global.I18n

參數(shù)：

返回值：

示例：

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

resolvedOptions8+

resolvedOptions(): RelativeTimeFormatResolvedOptions

獲取RelativeTimeFormat對象的格式化選項。

系統(tǒng)能力 ：SystemCapability.Global.I18n

返回值：

示例：

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

RelativeTimeFormatInputOptions8+[]()

表示RelativeTimeFormat對象可設置的屬性。

系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.Global.I18n

RelativeTimeFormatResolvedOptions8+[]()

表示RelativeTimeFormat對象可設置的屬性。

系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.Global.I18n

審核編輯 黃宇