國際化-Intl
說明:
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
導(dǎo)入模塊
import Intl from '@ohos.intl';
Locale
屬性
系統(tǒng)能力 :以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n
名稱 | 參數(shù)類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
language | string | 是 | 否 | 與區(qū)域設(shè)置關(guān)聯(lián)的語, 如:zh。 |
script | string | 是 | 否 | 語言的書寫方式,如:Hans。 |
region | string | 是 | 否 | 與區(qū)域設(shè)置相關(guān)的地區(qū),如:CN。 |
baseName | string | 是 | 否 | Locale的基本核心信息(由語言腳本與地區(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ū)域的時制信息,取值包括:"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 | 是 | 否 | 是否對數(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ù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
locale | string | 是 | 包含區(qū)域設(shè)置信息的字符串,包括語言以及可選的腳本和區(qū)域。 |
options | LocaleOptions | 否 | 用于創(chuàng)建區(qū)域?qū)ο蟮倪x項。 |
示例:
var locale = new Intl.Locale("zh-CN");
toString
toString(): string
將區(qū)域信息轉(zhuǎn)換為字符串
系統(tǒng)能力 :SystemCapability.Global.I18n
返回值:
類型 | 說明 |
---|---|
string | 字符串形式的區(qū)域信息。 |
示例:
var locale = new Intl.Locale("zh-CN");
locale.toString();
maximize
maximize(): Locale
最大化區(qū)域信息,若缺少腳本與地區(qū)信息,則補齊。
系統(tǒng)能力 :SystemCapability.Global.I18n
返回值:
類型 | 說明 |
---|---|
[Locale] | 最大化后的區(qū)域?qū)ο蟆?/td> |
示例:
var locale = new Intl.Locale("zh-CN");
locale.maximize();
minimize
minimize(): Locale
最小化區(qū)域信息,若包含腳本與地區(qū)信息,則去除。
系統(tǒng)能力 :SystemCapability.Global.I18n
返回值:
類型 | 說明 |
---|---|
[Locale] | 最小化后的區(qū)域?qū)ο蟆?/td> |
示例:
var locale = new Intl.Locale("zh-CN");
locale.minimize();
LocaleOptions
表示區(qū)域初始化選項。
系統(tǒng)能力 :以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n
名稱 | 參數(shù)類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
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 | 是 | 是 | 時制格式,取值包括:"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小時制。 |
caseFirst | string | 是 | 是 | 表示大寫、小寫的排序順序,取值范圍:"upper", "lower", "false"。 |
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ù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
locale | string | Array | 是 |
options | [DateTimeOptions] | 否 | 用于創(chuà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
格式化時間日期字符串。
系統(tǒng)能力 :SystemCapability.Global.I18n
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
date | Date | 是 | 時間日期對象。 |
返回值:
類型 | 說明 |
---|---|
string | 格式化后的時間日期字符串 |
示例:
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ù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
startDate | Date | 是 | 起始的時間日期。 |
endDate | Date | 是 | 結(jié)束的時間日期。 |
返回值:
類型 | 說明 |
---|---|
string | 格式化后的時間日期段字符串。 |
示例:
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
返回值:
類型 | 說明 |
---|---|
[DateTimeOptions] | DateTimeFormat 對象的格式化選項。 |
示例:
var datefmt = new Intl.DateTimeFormat("en-GB");
datefmt.resolvedOptions();
DateTimeOptions
表示時間日期格式化選項。
系統(tǒng)能力 :以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n
名稱 | 參數(shù)類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
locale | string | 是 | 否 | 區(qū)域參數(shù), 如:zh-Hans-CN。 |
dateStyle | string | 是 | 是 | 日期顯示格式,取值包括:"long", "short", "medium", "full"。 |
timeStyle | string | 是 | 是 | 時間顯示格式,取值包括:"long", "short", "medium", "full"。 |
hourCycle | string | 是 | 是 | 時制格式,取值包括:"h11", "h12", "h23", "h24"。 |
timeZone | string | 是 | 是 | 使用的時區(qū)(合法的IANA時區(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小時制。 |
weekday | string | 是 | 是 | 工作日的顯示格式,取值包括:"long", "short", "narrow"。 |
era | string | 是 | 是 | 時代的顯示格式,取值包括:"long", "short", "narrow"。 |
year | string | 是 | 是 | 年份的顯示格式,取值包括:"numeric", "2-digit"。 |
month | string | 是 | 是 | 月份的顯示格式,取值包括:"numeric", "2-digit", "long", "short", "narrow"。 |
day | string | 是 | 是 | 日期的顯示格式,取值包括:"numeric", "2-digit"。 |
hour | string | 是 | 是 | 小時的顯示格式,取值包括:"numeric", "2-digit"。 |
minute | string | 是 | 是 | 分鐘的顯示格式,取值包括:"numeric", "2-digit"。 |
second | string | 是 | 是 | 秒鐘的顯示格式,取值包括:"numeric", "2-digit"。 |
timeZoneName | string | 是 | 是 | 時區(qū)名稱的本地化表示。 |
dayPeriod | string | 是 | 是 | 時段的顯示格式,取值包括:"long", "short", "narrow"。 |
localeMatcher | string | 是 | 是 | 要使用的區(qū)域匹配算法,取值包括:"lookup", "best fit"。 |
formatMatcher | string | 是 | 是 | 要使用的格式匹配算法,取值包括:"basic", "best fit"。 |
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ù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
locale | string | Array | 是 |
options | [NumberOptions] | 否 | 用于創(chuàng)建數(shù)字格式化的選項。 |
示例:
var numfmt = new Intl.NumberFormat("en-GB", {style:'decimal', notation:"scientific"});
format
format(number: number): string;
格式化數(shù)字字符串。
系統(tǒng)能力 :SystemCapability.Global.I18n
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
number | number | 是 | 數(shù)字對象 |
返回值:
類型 | 說明 |
---|---|
string | 格式化后的數(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
返回值:
類型 | 說明 |
---|---|
[NumberOptions] | NumberFormat 對象的格式化選項。 |
示例:
var numfmt = new Intl.NumberFormat(["en-GB", "zh"], {style:'decimal', notation:"scientific"});
numfmt.resolvedOptions();
NumberOptions
表示設(shè)備支持的能力。
系統(tǒng)能力 :以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n
名稱 | 參數(shù)類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
locale | string | 是 | 否 | 區(qū)域參數(shù), 如:"zh-Hans-CN"。 |
currency | string | 是 | 是 | 貨幣單位, 如:"EUR","CNY","USD"等。 |
currencySign | string | 是 | 是 | 貨幣單位的符號顯示,取值包括: "symbol","narrowSymbol","code","name" 。 |
currencyDisplay | string | 是 | 是 | 貨幣的顯示方式,取值包括:"symbol", "narrowSymbol", "code", "name"。 |
unit | string | 是 | 是 | 單位名稱,如:"meter","inch",“hectare”等。 |
unitDisplay | string | 是 | 是 | 單位的顯示格式,取值包括:"long", "short", "narrow"。 |
unitUsage8+ | string | 是 | 是 | 單位的使用場景,取值包括:"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ù)字符號的顯示格式,取值包括:"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ù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
locale | string | Array | 是 |
options | [CollatorOptions] | 否 | 用于創(chuàng)建排序?qū)ο蟮倪x項。 |
示例:
var collator = new Intl.Collator("zh-CN", {localeMatcher: "lookup", usage: "sort"});
compare8+
compare(first: string, second: string): number
依據(jù)Collator的排序策略對兩個字符串進(jìn)行比較。
系統(tǒng)能力 :SystemCapability.Global.I18n
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
first | string | 是 | 進(jìn)行比較第一個字符串。 |
second | string | 是 | 進(jìn)行比較的第二個字符串。 |
返回值:
類型 | 說明 |
---|---|
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對象的屬性。
系統(tǒng)能力 :SystemCapability.Global.I18n
返回值:
類型 | 說明 |
---|---|
[CollatorOptions] | 返回的Collator對象的屬性。 |
示例:
var collator = new Intl.Collator("zh-Hans");
var options = collator.resolvedOptions();
CollatorOptions8+[]()
表示Collator可設(shè)置的屬性。
系統(tǒng)能力 :以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n
名稱 | 參數(shù)類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
localeMatcher | string | 是 | 是 | locale匹配算法,取值范圍:"best fit", "lookup"。 |
usage | string | 是 | 是 | 比較的用途,取值范圍:"sort", "search"。 |
sensitivity | string | 是 | 是 | 表示字符串中的哪些差異會導(dǎo)致非零結(jié)果值,取值范圍:"base", "accent", "case", "variant"。 |
ignorePunctuation | boolean | 是 | 是 | 表示是否忽略標(biā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對象。
系統(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ù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
locale | string | Array | 是 |
options | [PluralRulesOptions] | 否 | 用于創(chuàng)建單復(fù)數(shù)對象的選項。 |
示例:
var pluralRules= new Intl.PluraRules("zh-CN", {"localeMatcher": "lookup", "type": "cardinal"});
select8+
select(n: number): string
返回一個字符串表示該數(shù)字的單復(fù)數(shù)類別。
系統(tǒng)能力 :SystemCapability.Global.I18n
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
n | number | 是 | 待獲取單復(fù)數(shù)類別的數(shù)字。 |
返回值:
類型 | 說明 |
---|---|
string | 單復(fù)數(shù)類別,取值包括:"zero","one","two", "few", "many", "others"。 |
示例:
var pluralRules = new Intl.PluralRules("zh-Hans");
pluralRules.select(1);
PluralRulesOptions8+[]()
表示PluralRules對象可設(shè)置的屬性。
系統(tǒng)能力 :以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n
名稱 | 參數(shù)類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
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)建相對時間格式化對象。
系統(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ù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
locale | string | Array | 是 |
options | [RelativeTimeFormatInputOptions] | 否 | 用于創(chuàng)建相對時間格式化對象的選項。 |
示例:
var relativeTimeFormat = new Intl.RelativeTimeFormat("zh-CN", {"localeMatcher": "lookup", "numeric": "always", "style": "long"});
format8+
format(value: number, unit: string): string
依據(jù)locale和格式化選項,對value和unit進(jìn)行格式化。
系統(tǒng)能力 :SystemCapability.Global.I18n
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
value | number | 是 | 相對時間格式化的數(shù)值。 |
unit | string | 是 | 相對時間格式化的單位,取值包括:"year", "quarter", "month", "week", "day", "hour", "minute", "second"。 |
返回值:
類型 | 說明 |
---|---|
string | 格式化后的相對時間。 |
示例:
var relativetimefmt = new Intl.RelativeTimeFormat("zh-CN");
relativetimefmt.format(3, "quarter")
formatToParts8+
formatToParts(value: number, unit: string): Array
返回一個對象數(shù)組,表示可用于自定義區(qū)域設(shè)置格式的相對時間格式。
系統(tǒng)能力 :SystemCapability.Global.I18n
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
value | number | 是 | 相對時間格式化的數(shù)值。 |
unit | string | 是 | 相對時間格式化的單位,取值包括:"year", "quarter", "month", "week", "day", "hour", "minute", "second"。 |
返回值:
類型 | 說明 |
---|---|
Array | 返回可用于自定義區(qū)域設(shè)置格式的相對時間格式的對象數(shù)組。 |
示例:
var relativetimefmt = new Intl.RelativeTimeFormat("en", {"numeric": "auto"});
var parts = relativetimefmt.format(10, "seconds");
resolvedOptions8+
resolvedOptions(): RelativeTimeFormatResolvedOptions
獲取RelativeTimeFormat對象的格式化選項。
系統(tǒng)能力 :SystemCapability.Global.I18n
返回值:
類型 | 說明 |
---|---|
[RelativeTimeFormatResolvedOptions] | RelativeTimeFormat 對象的格式化選項。 |
示例:
var relativetimefmt= new Intl.RelativeTimeFormat("en-GB");
relativetimefmt.resolvedOptions();
RelativeTimeFormatInputOptions8+[]()
表示RelativeTimeFormat對象可設(shè)置的屬性。
系統(tǒng)能力 :以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n
名稱 | 參數(shù)類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
localeMatcher | string | 是 | 是 | locale匹配算法,取值包括:"best fit", "lookup"。 |
numeric | string | 是 | 是 | 輸出消息的格式,取值包括:"always", "auto"。 |
style | string | 是 | 是 | 國際化消息的長度,取值包括:"long", "short", "narrow"。 |
RelativeTimeFormatResolvedOptions8+[]()
表示RelativeTimeFormat對象可設(shè)置的屬性。
系統(tǒng)能力 :以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Global.I18n
名稱 | 參數(shù)類型 | 可讀 | 可寫 | 說明HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
---|---|---|---|---|
locale | string | 是 | 是 | 包含區(qū)域設(shè)置信息的字符串,包括語言以及可選的腳本和區(qū)域。 |
numeric | string | 是 | 是 | 輸出消息的格式,取值包括:"always", "auto"。 |
style | string | 是 | 是 | 國際化消息的長度,取值包括:"long", "short", "narrow"。 |
numberingSystem | string | 是 | 是 | 使用的數(shù)字系統(tǒng)。 |
審核編輯 黃宇
-
接口
+關(guān)注
關(guān)注
33文章
8575瀏覽量
151015 -
鴻蒙
+關(guān)注
關(guān)注
57文章
2339瀏覽量
42805
發(fā)布評論請先 登錄
相關(guān)推薦
評論