國(guó)際化-Intl

說(shuō)明：
開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 6開(kāi)始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
Intl模塊包含國(guó)際化能力基礎(chǔ)接口（在ECMA 402中定義）。

導(dǎo)入模塊

import Intl from '@ohos.intl';

Locale

屬性

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n

名稱	參數(shù)類型	可讀	可寫	說(shuō)明
language	string	是	否	與區(qū)域設(shè)置關(guān)聯(lián)的語(yǔ)，如：zh。
script	string	是	否	語(yǔ)言的書寫方式，如：Hans。
region	string	是	否	與區(qū)域設(shè)置相關(guān)的地區(qū)，如：CN。
baseName	string	是	否	Locale的基本核心信息（由語(yǔ)言腳本與地區(qū)組成），如：zh-Hans-CN。
caseFirst	string	是	否	區(qū)域的整理規(guī)則是否考慮大小寫，取值包括："upper", "lower", "false"。
calendar	string	是	否	區(qū)域的日歷信息，取值包括："buddhist", "chinese", "coptic","dangi", "ethioaa", "ethiopic", "gregory", "heew", "indian", "islamic", "islamic-umalqura", "islamic-tbla", "islamic-civil", "islamic-rgsa", "iso8601", "japanese", "persian", "roc", "islamicc"。
collation	string	是	否	區(qū)域的排序規(guī)則，取值包括："big5han", "compat", "dict", "direct", "ducet", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed", "searchjl", "stroke", "trad", "unihan", "zhuyin"。
hourCycle	string	是	否	區(qū)域的時(shí)制信息，取值包括："h12", "h23", "h11", "h24"。
numberingSystem	string	是	否	區(qū)域使用的數(shù)字系統(tǒng)，取值包括："adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "ah", "cakm", "cham", "deva", "diak", "fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho"。
numeric	boolean	是	否	是否對(duì)數(shù)字字符具有特殊的排序規(guī)則處理。

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ù)：

參數(shù)名	類型	必填	說(shuō)明
locale	string	是	包含區(qū)域設(shè)置信息的字符串，包括語(yǔ)言以及可選的腳本和區(qū)域。
options	LocaleOptions	否	用于創(chuàng)建區(qū)域?qū)ο蟮倪x項(xiàng)。

示例：

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

toString

toString(): string

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

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

返回值：

類型	說(shuō)明
string	字符串形式的區(qū)域信息。

示例：

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

maximize

maximize(): Locale

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

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

返回值：

類型	說(shuō)明
[Locale]	最大化后的區(qū)域?qū)ο蟆?/td>

示例：

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

minimize

minimize(): Locale

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

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

返回值：

類型	說(shuō)明
[Locale]	最小化后的區(qū)域?qū)ο蟆?/td>

示例：

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

LocaleOptions

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

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n

名稱	參數(shù)類型	可讀	可寫	說(shuō)明
calendar	string	是	是	日歷參數(shù)，如："buddhist", "chinese", "coptic", "dangi", "ethioaa", "ethiopic", "gregory", "heew", "indian", "islamic", "islamic-umalqura", "islamic-tbla", "islamic-civil", "islamic-rgsa", "iso8601", "japanese", "persian", "roc", "islamicc"。
collation	string	是	是	排序參數(shù)，取值包括："big5han", "compat", "dict", "direct", "ducet", "emoji", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed ", "search", "searchjl", "standard", "stroke", "trad", "unihan", "zhuyin"。
hourCycle	string	是	是	時(shí)制格式，取值包括："h11", "h12", "h23", "h24"。
numberingSystem	string	是	是	數(shù)字系統(tǒng)，取值包括："adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "ah", "cakm", "cham", "deva", "diak", "fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho"。
numeric	boolean	是	是	是否使用12小時(shí)制。
caseFirst	string	是	是	表示大寫、小寫的排序順序，取值范圍："upper", "lower", "false"。

DateTimeFormat

constructor8+

constructor()

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

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

示例：

var datefmt= new Intl.DateTimeFormat();

constructor

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

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

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
locale	string	Array	是
options	[DateTimeOptions]	否	用于創(chuàng)建時(shí)間日期格式化的選項(xiàng)。

示例：

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

格式化時(shí)間日期字符串。

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
date	Date	是	時(shí)間日期對(duì)象。

返回值：

類型	說(shuō)明
string	格式化后的時(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

格式化時(shí)間日期段字符串。

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
startDate	Date	是	起始的時(shí)間日期。
endDate	Date	是	結(jié)束的時(shí)間日期。

返回值：

類型	說(shuō)明
string	格式化后的時(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對(duì)象的格式化選項(xiàng)。

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

返回值：

類型	說(shuō)明
[DateTimeOptions]	DateTimeFormat 對(duì)象的格式化選項(xiàng)。

示例：

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

DateTimeOptions

表示時(shí)間日期格式化選項(xiàng)。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n

名稱	參數(shù)類型	可讀	可寫	說(shuō)明
locale	string	是	否	區(qū)域參數(shù)，如：zh-Hans-CN。
dateStyle	string	是	是	日期顯示格式，取值包括："long", "short", "medium", "full"。
timeStyle	string	是	是	時(shí)間顯示格式，取值包括："long", "short", "medium", "full"。
hourCycle	string	是	是	時(shí)制格式，取值包括："h11", "h12", "h23", "h24"。
timeZone	string	是	是	使用的時(shí)區(qū)（合法的IANA時(shí)區(qū)ID）。
numberingSystem	string	是	是	數(shù)字系統(tǒng)，取值包括："adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "ah", "cakm", "cham", "deva", "diak", "fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho"。
hour12	boolean	是	是	是否使用12小時(shí)制。
weekday	string	是	是	工作日的顯示格式，取值包括："long", "short", "narrow"。
era	string	是	是	時(shí)代的顯示格式，取值包括："long", "short", "narrow"。
year	string	是	是	年份的顯示格式，取值包括："numeric", "2-digit"。
month	string	是	是	月份的顯示格式，取值包括："numeric", "2-digit", "long", "short", "narrow"。
day	string	是	是	日期的顯示格式，取值包括："numeric", "2-digit"。
hour	string	是	是	小時(shí)的顯示格式，取值包括："numeric", "2-digit"。
minute	string	是	是	分鐘的顯示格式，取值包括："numeric", "2-digit"。
second	string	是	是	秒鐘的顯示格式，取值包括："numeric", "2-digit"。
timeZoneName	string	是	是	時(shí)區(qū)名稱的本地化表示。
dayPeriod	string	是	是	時(shí)段的顯示格式，取值包括："long", "short", "narrow"。
localeMatcher	string	是	是	要使用的區(qū)域匹配算法，取值包括："lookup", "best fit"。
formatMatcher	string	是	是	要使用的格式匹配算法，取值包括："basic", "best fit"。

NumberFormat

constructor8+

constructor()

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

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

示例：

var numfmt = new Intl.NumberFormat();

constructor

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

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

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
locale	string	Array	是
options	[NumberOptions]	否	用于創(chuàng)建數(shù)字格式化的選項(xiàng)。

示例：

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

format

format(number: number): string;

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

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
number	number	是	數(shù)字對(duì)象

返回值：

類型	說(shuō)明
string	格式化后的數(shù)字字符串

示例：

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

resolvedOptions

resolvedOptions(): NumberOptions

獲取NumberFormat 對(duì)象的格式化選項(xiàng)。

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

返回值：

類型	說(shuō)明
[NumberOptions]	NumberFormat 對(duì)象的格式化選項(xiàng)。

示例：

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

NumberOptions

表示設(shè)備支持的能力。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n

名稱	參數(shù)類型	可讀	可寫	說(shuō)明
locale	string	是	否	區(qū)域參數(shù)，如："zh-Hans-CN"。
currency	string	是	是	貨幣單位，如："EUR"，"CNY"，"USD"等。
currencySign	string	是	是	貨幣單位的符號(hào)顯示，取值包括： "symbol"，"narrowSymbol"，"code"，"name" 。
currencyDisplay	string	是	是	貨幣的顯示方式，取值包括："symbol", "narrowSymbol", "code", "name"。
unit	string	是	是	單位名稱，如："meter"，"inch"，“hectare”等。
unitDisplay	string	是	是	單位的顯示格式，取值包括："long", "short", "narrow"。
unitUsage8+	string	是	是	單位的使用場(chǎng)景，取值包括："default", "area-land-agricult", "area-land-commercl", "area-land-residntl", "length-person", "length-person-small", "length-rainfall", "length-road", "length-road-small", "length-snowfall", "length-vehicle", "length-visiblty", "length-visiblty-small", "length-person-informal", "length-person-small-informal", "length-road-informal", "speed-road-travel", "speed-wind", "temperature-person", "temperature-weather", "volume-vehicle-fuel"。
signDisplay	string	是	是	數(shù)字符號(hào)的顯示格式，取值包括："auto", "never", "always", "expectZero"。
compactDisplay	string	是	是	緊湊型的顯示格式，取值包括："long", "short"。
notation	string	是	是	數(shù)字的格式化規(guī)格，取值包括："standard", "scientific", "engineering", "compact"。
localeMatcher	string	是	是	要使用的區(qū)域匹配算法，取值包括："lookup", "best fit"。
style	string	是	是	數(shù)字的顯示格式，取值包括："decimal", "currency", "percent", "unit"。
numberingSystem	string	是	是	數(shù)字系統(tǒng)，取值包括："adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "ah", "cakm", "cham", "deva", "diak", "fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho"。
useGrouping	boolean	是	是	是否分組顯示。
minimumIntegerDigits	number	是	是	表示要使用的最小整數(shù)位數(shù)，取值范圍：1~21。
minimumFractionDigits	number	是	是	表示要使用的最小分?jǐn)?shù)位數(shù)，取值范圍：0~20。
maximumFractionDigits	number	是	是	表示要使用的最大分?jǐn)?shù)位數(shù)，取值范圍：1~21。
minimumSignificantDigits	number	是	是	表示要使用的最低有效位數(shù)，取值范圍：1~21。
maximumSignificantDigits	number	是	是	表示要使用的最大有效位數(shù)，取值范圍：1~21。

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ù)：

參數(shù)名	類型	必填	說(shuō)明
locale	string	Array	是
options	[CollatorOptions]	否	用于創(chuàng)建排序?qū)ο蟮倪x項(xiàng)。

示例：

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

compare8+

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

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

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
first	string	是	進(jìn)行比較第一個(gè)字符串。
second	string	是	進(jìn)行比較的第二個(gè)字符串。

返回值：

類型	說(shuō)明
number	比較結(jié)果。當(dāng)number為負(fù)數(shù)，表示first排序在second之前；當(dāng)number為0，表示first與second排序相同；當(dāng)number為正數(shù)，表示first排序在second之后。

示例：

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

resolvedOptions8+

resolvedOptions(): CollatorOptions

返回Collator對(duì)象的屬性。

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

返回值：

類型	說(shuō)明
[CollatorOptions]	返回的Collator對(duì)象的屬性。

示例：

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

CollatorOptions8+[]()

表示Collator可設(shè)置的屬性。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n

名稱	參數(shù)類型	可讀	可寫	說(shuō)明
localeMatcher	string	是	是	locale匹配算法，取值范圍："best fit", "lookup"。
usage	string	是	是	比較的用途，取值范圍："sort", "search"。
sensitivity	string	是	是	表示字符串中的哪些差異會(huì)導(dǎo)致非零結(jié)果值，取值范圍："base", "accent", "case", "variant"。
ignorePunctuation	boolean	是	是	表示是否忽略標(biāo)點(diǎn)符號(hào)，取值范圍：true, false。
collation	string	是	是	排序規(guī)則，取值范圍："big5han", "compat", "dict", "direct", "ducet", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed", "searchjl", "stroke", "trad", "unihan", "zhuyin"。
numeric	boolean	是	是	是否使用數(shù)字排序，取值范圍：true, false。
caseFirst	string	是	是	表示大寫、小寫的排序順序，取值范圍："upper", "lower", "false"。

PluralRules8+

constructor8+

constructor()

創(chuàng)建PluralRules對(duì)象。

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

示例：

var pluralRules = new Intl.PluralRules();

constructor8+

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

創(chuàng)建PluralRules對(duì)象。

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
locale	string	Array	是
options	[PluralRulesOptions]	否	用于創(chuàng)建單復(fù)數(shù)對(duì)象的選項(xiàng)。

示例：

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

select8+

select(n: number): string

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

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
n	number	是	待獲取單復(fù)數(shù)類別的數(shù)字。

返回值：

類型	說(shuō)明
string	單復(fù)數(shù)類別，取值包括："zero"，"one"，"two", "few", "many", "others"。

示例：

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

PluralRulesOptions8+[]()

表示PluralRules對(duì)象可設(shè)置的屬性。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n

名稱	參數(shù)類型	可讀	可寫	說(shuō)明
localeMatcher	string	是	是	locale匹配算法，取值包括："best fit", "lookup"。
type	string	是	是	排序的類型，取值包括："cardinal", "ordinal"。
minimumIntegerDigits	number	是	是	表示要使用的最小整數(shù)位數(shù)，取值范圍：1~21。
minimumFractionDigits	number	是	是	表示要使用的最小分?jǐn)?shù)位數(shù)，取值范圍：0~20。
maximumFractionDigits	number	是	是	表示要使用的最大分?jǐn)?shù)位數(shù)，取值范圍：1~21。
minimumSignificantDigits	number	是	是	表示要使用的最低有效位數(shù)，取值范圍：1~21。
maximumSignificantDigits	number	是	是	表示要使用的最大有效位數(shù)，取值范圍：1~21。

RelativeTimeFormat8+

constructor8+

constructor()

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

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

示例：

var relativetimefmt = new Intl.RelativeTimeFormat();

constructor8+

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

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

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
locale	string	Array	是
options	[RelativeTimeFormatInputOptions]	否	用于創(chuàng)建相對(duì)時(shí)間格式化對(duì)象的選項(xiàng)。

示例：

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

format8+

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

依據(jù)locale和格式化選項(xiàng)，對(duì)value和unit進(jìn)行格式化。

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
value	number	是	相對(duì)時(shí)間格式化的數(shù)值。
unit	string	是	相對(duì)時(shí)間格式化的單位，取值包括："year", "quarter", "month", "week", "day", "hour", "minute", "second"。

返回值：

類型	說(shuō)明
string	格式化后的相對(duì)時(shí)間。

示例：

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

formatToParts8+

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

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

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

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
value	number	是	相對(duì)時(shí)間格式化的數(shù)值。
unit	string	是	相對(duì)時(shí)間格式化的單位，取值包括："year", "quarter", "month", "week", "day", "hour", "minute", "second"。

返回值：

類型	說(shuō)明
Array	返回可用于自定義區(qū)域設(shè)置格式的相對(duì)時(shí)間格式的對(duì)象數(shù)組。

示例：

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

resolvedOptions8+

resolvedOptions(): RelativeTimeFormatResolvedOptions

獲取RelativeTimeFormat對(duì)象的格式化選項(xiàng)。

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

返回值：

類型	說(shuō)明
[RelativeTimeFormatResolvedOptions]	RelativeTimeFormat 對(duì)象的格式化選項(xiàng)。

示例：

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

RelativeTimeFormatInputOptions8+[]()

表示RelativeTimeFormat對(duì)象可設(shè)置的屬性。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n

名稱	參數(shù)類型	可讀	可寫	說(shuō)明
localeMatcher	string	是	是	locale匹配算法，取值包括："best fit", "lookup"。
numeric	string	是	是	輸出消息的格式，取值包括："always", "auto"。
style	string	是	是	國(guó)際化消息的長(zhǎng)度，取值包括："long", "short", "narrow"。

RelativeTimeFormatResolvedOptions8+[]()

表示RelativeTimeFormat對(duì)象可設(shè)置的屬性。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n

新文檔.png

名稱	參數(shù)類型	可讀	可寫	說(shuō)明`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
locale	string	是	是	包含區(qū)域設(shè)置信息的字符串，包括語(yǔ)言以及可選的腳本和區(qū)域。
numeric	string	是	是	輸出消息的格式，取值包括："always", "auto"。
style	string	是	是	國(guó)際化消息的長(zhǎng)度，取值包括："long", "short", "narrow"。
numberingSystem	string	是	是	使用的數(shù)字系統(tǒng)。

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問(wèn)題，請(qǐng)聯(lián)系本站處理。舉報(bào)投訴

接口

接口

+關(guān)注

關(guān)注
33

文章
9005

瀏覽量
153769
鴻蒙

鴻蒙

+關(guān)注

關(guān)注
60

文章
2620

瀏覽量
44063

搜索歷史

鴻蒙開(kāi)發(fā)接口資源管理：【@ohos.intl (國(guó)際化-Intl)】

國(guó)際化-Intl

導(dǎo)入模塊

Locale

屬性

constructor8+

constructor

toString

maximize

minimize

LocaleOptions

DateTimeFormat

constructor8+

constructor

format

formatRange

resolvedOptions

DateTimeOptions

NumberFormat

constructor8+

constructor

format

resolvedOptions

NumberOptions

Collator8+

constructor8+

constructor8+

compare8+

resolvedOptions8+

CollatorOptions8+[]()

PluralRules8+

constructor8+

constructor8+

select8+

PluralRulesOptions8+[]()

RelativeTimeFormat8+

constructor8+

constructor8+

format8+

formatToParts8+

resolvedOptions8+

RelativeTimeFormatInputOptions8+[]()

RelativeTimeFormatResolvedOptions8+[]()

評(píng)論