0
  • 聊天消息
  • 系統(tǒng)消息
  • 評論與回復(fù)
登錄后你可以
  • 下載海量資料
  • 學(xué)習(xí)在線課程
  • 觀看技術(shù)視頻
  • 寫文章/發(fā)帖/加入社區(qū)
會員中心
創(chuàng)作中心

完善資料讓更多小伙伴認(rèn)識你,還能領(lǐng)取20積分哦,立即完善>

3天內(nèi)不再提示

鴻蒙開發(fā)接口資源管理:【@ohos.i18n (國際化-I18n)】

jf_46214456 ? 來源:jf_46214456 ? 作者:jf_46214456 ? 2024-06-03 09:59 ? 次閱讀

國際化-I18n

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

  • 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口,采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
  • I18N模塊包含國際化能力增強(qiáng)接口(未在ECMA 402中定義)。

導(dǎo)入模塊

import i18n from '@ohos.i18n';

i18n.getDisplayLanguage

getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): string

獲取指定語言的本地化顯示文本。

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

參數(shù)

參數(shù)名類型必填說明
languagestring指定語言。
localestring顯示指定語言的區(qū)域ID。
sentenceCaseboolean本地化顯示文本是否要首字母大寫。

返回值:

類型說明
string指定語言的本地化顯示文本。

示例:

i18n.getDisplayLanguage("zh", "en-GB", true);
i18n.getDisplayLanguage("zh", "en-GB");

i18n.getDisplayCountry

getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): string

獲取指定國家的本地化顯示文本。

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

參數(shù):

參數(shù)名類型必填說明
countrystring指定國家。
localestring顯示指定國家的區(qū)域ID。
sentenceCaseboolean本地化顯示文本是否要首字母大寫。

返回值:

類型說明
string指定國家的本地化顯示文本。

示例:

i18n.getDisplayCountry("zh-CN", "en-GB", true);
i18n.getDisplayCountry("zh-CN", "en-GB");

i18n.isRTL7+

isRTL(locale: string): boolean

獲取是否為從右至左顯示語言。

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

參數(shù):

參數(shù)名類型說明
localestring指定區(qū)域ID。

返回值:

類型說明
booleantrue表示該locale從右至左顯示語言;false表示該locale從左至右顯示語言。

示例:

i18n.isRTL("zh-CN");// 中文不是RTL語言,返回false
i18n.isRTL("ar-EG");// 阿語是RTL語言,返回true

i18n.getSystemLanguage

getSystemLanguage(): string

獲取系統(tǒng)語言。

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

返回值:

類型說明
string系統(tǒng)語言ID。

示例:

i18n.getSystemLanguage();

i18n.setSystemLanguage

setSystemLanguage(language: string): boolean

設(shè)置系統(tǒng)語言。

需要權(quán)限 :ohos.permission.UPDATE_CONFIGURATION

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

系統(tǒng)API : 該接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。

參數(shù):

參數(shù)名類型說明
languagestring語言ID。

返回值:

類型說明
boolean返回true,表示系統(tǒng)語言設(shè)置成功;返回false,表示系統(tǒng)語言設(shè)置失敗。

示例:

i18n.setSystemLanguage('zh');

i18n.getSystemLanguages

getSystemLanguages(): Array

獲取系統(tǒng)支持的語言列表。

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

系統(tǒng)API : 該接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。

返回值:

類型說明
Array系統(tǒng)支持的語言ID列表。

示例:

i18n.getSystemLanguages();

i18n.getSystemCountries

getSystemCountries(language: string): Array

獲取針對輸入語言系統(tǒng)支持的區(qū)域列表。

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

系統(tǒng)API : 該接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。

參數(shù):

參數(shù)名類型說明
languagestring語言ID。

返回值:

類型說明
Array系統(tǒng)支持的區(qū)域ID列表。

示例:

i18n.getSystemCountries('zh');

i18n.getSystemRegion

getSystemRegion(): string

獲取系統(tǒng)地區(qū)。

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

返回值:

類型說明
string系統(tǒng)地區(qū)ID。

示例:

i18n.getSystemRegion();

i18n.setSystemRegion

setSystemRegion(region: string): boolean

設(shè)置系統(tǒng)區(qū)域。

需要權(quán)限 :ohos.permission.UPDATE_CONFIGURATION

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

系統(tǒng)API : 該接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。

參數(shù):

參數(shù)名類型說明
regionstring地區(qū)ID。

返回值:

類型說明
boolean返回true,表示系統(tǒng)區(qū)域設(shè)置成功;返回false,表示系統(tǒng)區(qū)域設(shè)置失敗。

示例:

i18n.setSystemRegion('CN');

i18n.getSystemLocale

getSystemLocale(): string

獲取系統(tǒng)區(qū)域。

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

返回值:

類型說明
string系統(tǒng)區(qū)域ID。

示例:

i18n.getSystemLocale();

i18n.setSystemLocale

setSystemLocale(locale: string): boolean

設(shè)置系統(tǒng)Locale。

需要權(quán)限 :ohos.permission.UPDATE_CONFIGURATION

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

系統(tǒng)API : 該接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。

參數(shù):

參數(shù)名類型說明
localestring指定區(qū)域ID,例如zh-CN。

返回值:

類型說明
boolean返回true,表示系統(tǒng)Locale設(shè)置成功;返回false,表示系統(tǒng)Locale設(shè)置失敗。

示例:

i18n.setSystemLocale('zh-CN');

i18n.isSuggested

isSuggested(language: string, region?: string): boolean

判斷當(dāng)前語言和區(qū)域是否匹配。

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

系統(tǒng)API : 該接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。

參數(shù):

參數(shù)名類型必填說明
languagestring合法的語言ID,例如zh。
regionstring合法的地區(qū)ID,例如CN

返回值:

類型說明
boolean返回true,表示當(dāng)前語言和地區(qū)匹配;返回false,表示當(dāng)前語言和地區(qū)不匹配。

示例:

i18n.isSuggested('zh', 'CN');

i18n.getCalendar8+

getCalendar(locale: string, type? : string): Calendar

獲取日歷對象。

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

參數(shù):

參數(shù)名類型必填說明
localestring合法的locale值,例如zh-Hans-CN。
typestring合法的日歷類型,目前合法的類型有buddhist, chinese, coptic, ethiopic, heew, gregory, indian, islamic_civil, islamic_tbla, islamic_umalqura, japanese, persian。當(dāng)type沒有給出時,采用區(qū)域默認(rèn)的日歷類型。

返回值:

類型說明
[Calendar]日歷對象。

示例:

i18n.getCalendar("zh-Hans", "gregory");

Calendar8+

setTime8+

setTime(date: Date): void

設(shè)置日歷對象內(nèi)部的時間日期。

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

參數(shù):

參數(shù)名類型必填說明
dateDate將要設(shè)置的日歷對象的內(nèi)部時間日期。

示例:

var calendar = i18n.getCalendar("en-US", "gregory");
var date = new Date(2021, 10, 7, 8, 0, 0, 0);
calendar.setTime(date);

setTime8+

setTime(time: number): void

設(shè)置日歷對象內(nèi)部的時間日期, time為從1970.1.1 00:00:00 GMT逝去的毫秒數(shù)。

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

參數(shù):

參數(shù)名類型必填說明
timenumbertime為從1970.1.1 00:00:00 GMT逝去的毫秒數(shù)。

示例:

var calendar = i18n.getCalendar("en-US", "gregory");
calendar.setTime(10540800000);

set8+

set(year: number, month: number, date:number, hour?: number, minute?: number, second?: number): void

設(shè)置日歷對象的年、月、日、時、分、秒。

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

參數(shù):

參數(shù)名類型必填說明
yearnumber設(shè)置的年。
monthnumber設(shè)置的月。
datenumber設(shè)置的日。
hournumber設(shè)置的小時。
minutenumber設(shè)置的分鐘。
secondnumber設(shè)置的秒。

示例:

var calendar = i18n.getCalendar("zh-Hans");
calendar.set(2021, 10, 1, 8, 0, 0); // set time to 2021.10.1 08:00:00

setTimeZone8+

setTimeZone(timezone: string): void

設(shè)置日歷對象的時區(qū)。

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

參數(shù):

參數(shù)名類型必填說明
timezonestring設(shè)置的時區(qū)id,如“Asia/Shanghai”。

示例:

var calendar = i18n.getCalendar("zh-Hans");
calendar.setTimeZone("Asia/Shanghai");

getTimeZone8+

getTimeZone(): string

獲取日歷對象的時區(qū)。

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

返回值:

類型說明
string日歷對象的時區(qū)id。

示例:

var calendar = i18n.getCalendar("zh-Hans");
calendar.setTimeZone("Asia/Shanghai");
calendar.getTimeZone(); // Asia/Shanghai"

getFirstDayOfWeek8+

getFirstDayOfWeek(): number

獲取日歷對象的一周起始日。

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

返回值:

類型說明
number獲取一周的起始日,1代表周日,7代表周六。

示例:

var calendar = i18n.getCalendar("en-US", "gregory");
calendar.getFirstDayOfWeek();

setFirstDayOfWeek8+

setFirstDayOfWeek(value: number): void

設(shè)置每一周的起始日。

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

參數(shù):

參數(shù)名類型必填說明
valuenumber設(shè)置一周的起始日,1代表周日,7代表周六。

示例:

var calendar = i18n.getCalendar("zh-Hans");
calendar.setFirstDayOfWeek(0);

getMinimalDaysInFirstWeek8+

getMinimalDaysInFirstWeek(): number

獲取一年中第一周的最小天數(shù)。

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

返回值:

類型說明
number一年中第一周的最小天數(shù)。

示例:

var calendar = i18n.getCalendar("zh-Hans");
calendar.getMinimalDaysInFirstWeek();

setMinimalDaysInFirstWeek8+

setMinimalDaysInFirstWeek(value: number): void

設(shè)置一年中第一周的最小天數(shù)。

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

參數(shù):

參數(shù)名類型必填說明
valuenumber一年中第一周的最小天數(shù)。

示例:

var calendar = i18n.getCalendar("zh-Hans");
calendar.setMinimalDaysInFirstWeek(3);

get8+

get(field: string): number

獲取日歷對象中與field相關(guān)聯(lián)的值。

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

參數(shù):

參數(shù)名類型必填說明
fieldstring通過field來獲取日歷對象相應(yīng)的值。目前支持的field值有 era, year, month, week_of_year, week_of_month, date, day_of_year, day_of_week, day_of_week_in_month, hour, hour_of_day, minute, second, millisecond, zone_offset, dst_offset, year_woy, dow_local, extended_year, julian_day, milliseconds_in_day, is_leap_month。

返回值:

類型說明
number與field相關(guān)聯(lián)的值,如當(dāng)前Calendar對象的內(nèi)部日期的年份為1990,get("year")返回1990。

示例:

var calendar = i18n.getCalendar("zh-Hans");
calendar.set(2021, 10, 1, 8, 0, 0); // set time to 2021.10.1 08:00:00
calendar.get("hour_of_day"); // 8

getDisplayName8+

getDisplayName(locale: string): string

獲取日歷對象在locale所指定的區(qū)域的名字。

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

參數(shù):

參數(shù)名類型必填說明
localestringlocale指定獲取哪個區(qū)域下該calendar的名字,如buddhist在en-US上顯示的名稱為“Buddhist Calendar”。

返回值:

類型說明
string日歷在locale所指示的區(qū)域的名字。

示例:

var calendar = i18n.getCalendar("en-US", "buddhist");
calendar.getDisplayName("zh"); // 佛歷

isWeekend8+

isWeekend(date?: Date): boolean

判斷給定的日期是否在日歷中是周末。

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

參數(shù):

參數(shù)名類型必填說明
dateDate判斷日期在日歷中是否是周末。如果date沒有給出,判斷calendar當(dāng)前日期是否為周末。

返回值:

類型說明
boolean當(dāng)所判斷的日期為周末時,返回 true,否則返回false。

示例:

var calendar = i18n.getCalendar("zh-Hans");
calendar.set(2021, 11, 11, 8, 0, 0); // set time to 2021.11.11 08:00:00
calendar.isWeekend(); // false
var date = new Date(2011, 11, 6, 9, 0, 0);
calendar.isWeekend(date); // true

PhoneNumberFormat8+

constructor8+

constructor(country: string, options?: PhoneNumberFormatOptions)

創(chuàng)建電話號碼格式化對象。

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

參數(shù):

參數(shù)名類型必填說明
countrystring表示電話號碼所屬國家或地區(qū)代碼。
options[PhoneNumberFormatOptions]電話號碼格式化對象的相關(guān)選項(xiàng)。

示例:

var phoneNumberFormat= new i18n.PhoneNumberFormat("CN", {"type": "E164"});

isValidNumber8+

isValidNumber(number: string): boolean

判斷傳入的電話號碼格式是否正確。

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

參數(shù):

參數(shù)名類型必填說明
numberstring待判斷的電話號碼。

返回值:

類型說明
boolean返回true表示電話號碼的格式正確,返回false表示電話號碼的格式錯誤。

示例:

var phonenumberfmt = new i18n.PhoneNumberFormat("CN");
phonenumberfmt.isValidNumber("15812312312");

format8+

format(number: string): string

對電話號碼進(jìn)行格式化。

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

參數(shù):

參數(shù)名類型必填說明
numberstring待格式化的電話號碼。

返回值:

類型說明
string格式化后的電話號碼。

示例:

var phonenumberfmt = new i18n.PhoneNumberFormat("CN");
phonenumberfmt.format("15812312312");

PhoneNumberFormatOptions8+

表示電話號碼格式化對象可設(shè)置的屬性。

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

名稱參數(shù)類型可讀可寫說明
typestring表示對電話號碼格式化的類型,取值范圍:"E164", "INTERNATIONAL", "NATIONAL", "RFC3966"。

UnitInfo8+

度量衡單位信息。

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

名稱參數(shù)類型可讀可寫說明
unitstring單位的名稱,如:"meter", "inch", "cup"等。
measureSystemstring單位的度量體系,取值包括:"SI", "US", "UK"。

Util8+

unitConvert8+

unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale: string, style?: string): string

將fromUnit的單位轉(zhuǎn)換為toUnit的單位,并根據(jù)區(qū)域與風(fēng)格進(jìn)行格式化。

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

參數(shù):

參數(shù)名類型必填說明
fromUnit[UnitInfo]要被轉(zhuǎn)換的單位。
toUnit[UnitInfo]要轉(zhuǎn)換為的單位。
valuenumber要被轉(zhuǎn)換的單位的數(shù)量值。
localestring格式化時使用的區(qū)域參數(shù),如:zh-Hans-CN。
stylestring格式化使用的風(fēng)格,取值包括:"long", "short", "narrow"。

返回值:

類型說明
string按照toUnit的單位格式化后,得到的字符串。

示例:

i18n.Util.unitConvert({unit: "cup", measureSystem: "US"}, {unit: "liter", measureSystem: "SI"}, 1000, "en-US", "long");

getInstance8+

getInstance(locale?:string): IndexUtil

創(chuàng)建并返回IndexUtil對象。

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

參數(shù):

參數(shù)名類型必填說明
localestring包含區(qū)域設(shè)置信息的字符串,包括語言以及可選的腳本和區(qū)域。

返回值:

類型說明
[IndexUtil]locale對應(yīng)的IndexUtil對象。

示例:

var indexUtil= i18n.getInstance("zh-CN");

IndexUtil8+

getIndexList8+

getIndexList(): Array

獲取當(dāng)前l(fā)ocale對應(yīng)的索引列表。

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

返回值:

類型說明
Array返回當(dāng)前l(fā)ocale對應(yīng)的索引列表。

示例:

var indexUtil = i18n.getInstance("zh-CN");
var indexList = indexUtil.getIndexList();

addLocale8+

addLocale(locale: string): void

將新的locale對應(yīng)的索引加入當(dāng)前索引列表。

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

參數(shù):

參數(shù)名類型必填說明
localestring包含區(qū)域設(shè)置信息的字符串,包括語言以及可選的腳本和區(qū)域。

示例:

var indexUtil = i18n.getInstance("zh-CN");
indexUtil.addLocale("en-US");

getIndex8+

getIndex(text: string): string

獲取text對應(yīng)的索引。

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

參數(shù):

參數(shù)名類型必填說明
textstring待計(jì)算索引值的輸入文本。

返回值:

類型說明
string輸入文本對應(yīng)的索引值。

示例:

var indexUtil= i18n.getInstance("zh-CN");
indexUtil.getIndex("hi");  // 返回h

Character8+

isDigit8+

isDigit(char: string): boolean

判斷字符串char是否是數(shù)字。

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

參數(shù):

參數(shù)名類型必填說明
charstring輸入字符。

返回值:

類型說明
boolean返回true表示輸入的字符是數(shù)字,返回false表示輸入的字符不是數(shù)字。

示例:

var isdigit = i18n.Character.isDigit("1");  // 返回true

isSpaceChar8+

isSpaceChar(char: string): boolean

判斷字符串char是否是空格符。

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

參數(shù):

參數(shù)名類型必填說明
charstring輸入字符。

返回值:

類型說明
boolean返回true表示輸入的字符是空格符,返回false表示輸入的字符不是空格符。

示例:

var isspacechar = i18n.Character.isSpaceChar("a");  // 返回false

isWhitespace8+

isWhitespace(char: string): boolean

判斷字符串char是否是空白符。

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

參數(shù):

參數(shù)名類型必填說明
charstring輸入字符。

返回值:

類型說明
boolean返回true表示輸入的字符是空白符,返回false表示輸入的字符不是空白符。

示例:

var iswhitespace = i18n.Character.isWhitespace("a");  // 返回false

isRTL8+

isRTL(char: string): boolean

判斷字符串char是否是從右到左語言的字符。

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

參數(shù):

參數(shù)名類型必填說明
charstring輸入字符。

返回值:

類型說明
boolean返回true表示輸入的字符是從右到左語言的字符,返回false表示輸入的字符不是從右到左語言的字符。

示例:

var isrtl = i18n.Character.isRTL("a");  // 返回false

isIdeograph8+

isIdeograph(char: string): boolean

判斷字符串char是否是表意文字。

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

參數(shù):

參數(shù)名類型必填說明
charstring輸入字符。

返回值:

類型說明
boolean返回true表示輸入的字符是表意文字,返回false表示輸入的字符不是表意文字。

示例:

var isideograph = i18n.Character.isIdeograph("a");  // 返回false

isLetter8+

isLetter(char: string): boolean

判斷字符串char是否是字母。

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

參數(shù):

參數(shù)名類型必填說明
charstring輸入字符。

返回值:

類型說明
boolean返回true表示輸入的字符是字母,返回false表示輸入的字符不是字母。

示例:

var isletter = i18n.Character.isLetter("a");  // 返回true

isLowerCase8+

isLowerCase(char: string): boolean

判斷字符串char是否是小寫字母。

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

參數(shù):

參數(shù)名類型必填說明
charstring輸入字符。

返回值:

類型說明
boolean返回true表示輸入的字符是小寫字母,返回false表示輸入的字符不是小寫字母。

示例:

var islowercase = i18n.Character.isLowerCase("a");  // 返回true

isUpperCase8+

isUpperCase(char: string): boolean

判斷字符串char是否是大寫字母。

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

參數(shù):

參數(shù)名類型必填說明
charstring輸入字符。

返回值:

類型說明
boolean返回true表示輸入的字符是大寫字母,返回false表示輸入的字符不是大寫字母。

示例:

var isuppercase = i18n.Character.isUpperCase("a");  // 返回false

getType8+

getType(char: string): string

獲取輸入字符串的一般類別值。

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

參數(shù):

參數(shù)名類型必填說明
charstring輸入字符。

返回值:

類型說明
string輸入字符的一般類別值。

示例:

var type = i18n.Character.getType("a");

i18n.getLineInstance8+

getLineInstance(locale: string): BreakIterator

獲取一個用于斷句的[BreakIterator]對象。

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

參數(shù):

參數(shù)名類型必填說明
localestring合法的locale值,例如zh-Hans-CN。生成的[BreakIterator]將按照locale所指定的區(qū)域的規(guī)則來進(jìn)行斷句。

返回值:

類型說明
[BreakIterator]用于進(jìn)行斷句的處理器。

示例:

var iterator = i18n.getLineInstance("en");

BreakIterator8+

setLineBreakText8+

setLineBreakText(text: string): void

設(shè)置[BreakIterator]要處理的文本。

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

參數(shù):

參數(shù)名類型必填說明
textstring指定BreakIterator進(jìn)行斷句的文本。

示例:

var iterator = i18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");

getLineBreakText8+

getLineBreakText(): string

獲取[BreakIterator]當(dāng)前處理的文本。

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

返回值:

類型說明
stringBreakIterator對象正在處理的文本

示例:

var iterator = i18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
iterator.getLineBreakText(); // Apple is my favorite fruit.

current8+

current(): number

獲取[BreakIterator]對象在當(dāng)前處理的文本中的位置。

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

返回值:

類型說明
numberBreakIterator在當(dāng)前所處理的文本中的位置。

示例:

var iterator = i18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
breakIter.current(); // 0

first8+

first(): number

將[BreakIterator]對象設(shè)置到第一個可斷句的分割點(diǎn)。第一個分割點(diǎn)總是被處理的文本的起始位置。

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

返回值:

類型說明
number被處理文本的第一個分割點(diǎn)的偏移量。

示例:

var iterator = i18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
breakIter.first(); // 0

last8+

last(): number

將[BreakIterator]對象的位置設(shè)置到最后一個可斷句的分割點(diǎn)。最后一個分割點(diǎn)總是被處理文本末尾的下一個位置。

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

返回值:

類型說明
number被處理的文本的最后一個分割點(diǎn)的偏移量

示例:

var iterator = i18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
iterator.last(); // 27

next8+

next(index?: number): number

如果index給出,并且index是一個正數(shù)將[BreakIterator]向后移動number個可斷句的分割點(diǎn),如果n是一個負(fù)數(shù),向前移動相應(yīng)個分割點(diǎn)。若index沒有給出,則相當(dāng)于index = 1。

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

參數(shù):

參數(shù)名類型必填說明
indexnumber[BreakIterator]將要移動的分割點(diǎn)數(shù),正數(shù)代表向后移動,負(fù)數(shù)代表向前移動。若index沒有給出,則按照index=1處理。

返回值:

類型說明
number返回移動了index個分割點(diǎn)后,當(dāng)前[BreakIterator]在文本中的位置。若移動index個分割點(diǎn)后超出了所處理的文本的長度范圍,返回-1。

示例:

var iterator = i18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
iterator.first(); // 0
iterator.next(); // 6
iterator.next(10); // -1

previous8+

previous(): number

將[BreakIterator]移動到前一個分割點(diǎn)處。

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

返回值:

類型說明
number返回移動到前一個分割點(diǎn)后,當(dāng)前[BreakIterator]在文本中的位置。若移動index個分割點(diǎn)后超出了所處理的文本的長度范圍,返回-1。

示例:

var iterator = i18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
iterator.first(); // 0
iterator.next(3); // 12
iterator.previous(); // 9

following8+

following(offset: number): number

將[BreakIterator]設(shè)置到由offset指定的位置的后面一個分割點(diǎn)。返回移動后[BreakIterator]的位置。

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

參數(shù):

參數(shù)名類型必填說明
offsetnumber將[BreakIterator]對象的位置設(shè)置到由offset所指定的位置的下一個分割點(diǎn)。

返回值:

類型說明
number返回[BreakIterator]移動后的位置,如果由offset所指定的位置的下一個分割點(diǎn)超出了文本的范圍則返回-1。

示例:

var iterator = i18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
iterator.following(0); // 6
iterator.following(100); // -1
iterator.current(); // 27

isBoundary8+

isBoundary(offset: number): boolean

如果offset所指定的文本位置是一個分割點(diǎn),那么返回true,否則返回false。如果返回true, 將[BreakIterator]對象設(shè)置到offset所指定的位置, 否則相當(dāng)于調(diào)用[following]。

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

參數(shù):

參數(shù)名類型必填說明
offsetnumber指定需要進(jìn)行判斷的位置

返回值:

類型說明
boolean如果是一個分割點(diǎn)返回true, 否則返回false。

示例:

var iterator = i18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
iterator.isBoundary(0); // true;
iterator.isBoundary(5); // false;

i18n.is24HourClock7+

is24HourClock(): boolean

判斷系統(tǒng)時間是否為24小時制。

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

返回值:

類型說明
boolean返回true,表示系統(tǒng)24小時開關(guān)開啟;返回false,表示系統(tǒng)24小時開關(guān)關(guān)閉。

示例:

var is24HourClock = i18n.is24HourClock();

i18n.set24HourClock7+

set24HourClock(option: boolean): boolean

修改系統(tǒng)時間的24小時制設(shè)置。

需要權(quán)限 :ohos.permission.UPDATE_CONFIGURATION

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

參數(shù):

參數(shù)名類型必填說明
optionbooleanoption為true,表示開啟系統(tǒng)24小時制開關(guān);返回false,表示關(guān)閉系統(tǒng)24小時開關(guān)。

返回值:

類型說明
boolean返回true,表示修改成功;返回false,表示修改失敗。

示例:

// 將系統(tǒng)時間設(shè)置為24小時制
var success = i18n.set24HourClock(true);

i18n.addPreferredLanguage8+

addPreferredLanguage(language: string, index?: number): boolean

在系統(tǒng)偏好語言列表中的指定位置添加偏好語言。

需要權(quán)限 :ohos.permission.UPDATE_CONFIGURATION

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

參數(shù):

參數(shù)名類型必填說明
languagestring待添加的偏好語言。
indexnumber偏好語言的添加位置。

返回值:

類型說明
boolean返回true,表示添加成功;返回false,表示添加失敗。

示例:

// 將語言zh-CN添加到系統(tǒng)偏好語言列表中
var language = 'zh-CN';
var index = 0;
var success = i18n.addPreferredLanguage(language, index);

i18n.removePreferredLanguage8+

removePreferredLanguage(index: number): boolean

刪除系統(tǒng)偏好語言列表中指定位置的偏好語言。

需要權(quán)限 :ohos.permission.UPDATE_CONFIGURATION

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

參數(shù):

參數(shù)名類型必填說明
indexnumber待刪除偏好語言在系統(tǒng)偏好語言列表中的位置。

返回值:

類型說明
boolean返回true,表示刪除成功;返回false,表示刪除失敗。

示例:

// 刪除系統(tǒng)偏好語言列表中的第一個偏好語言
var index = 0;
var success = i18n.removePreferredLanguage(index);

i18n.getPreferredLanguageList8+

getPreferredLanguageList(): Array

獲取系統(tǒng)偏好語言列表。

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

返回值:

類型說明
Array系統(tǒng)偏好語言列表。

示例:

var preferredLanguageList = i18n.getPreferredLanguageList();

i18n.getFirstPreferredLanguage8+

getFirstPreferredLanguage(): string

獲取偏好語言列表中的第一個偏好語言。

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

返回值:

類型說明
string偏好語言列表中的第一個語言。

示例:

var firstPreferredLanguage = i18n.getFirstPreferredLanguage();

i18n.getAppPreferredLanguage9+

getAppPreferredLanguage(): string

獲取應(yīng)用的偏好語言。

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

返回值:

類型說明
string應(yīng)用的偏好語言。

示例:

var appPreferredLanguage = i18n.getAppPreferredLanguage();

i18n.getTimeZone7+

getTimeZone(zoneID?: string): TimeZone

獲取時區(qū)ID對應(yīng)的時區(qū)對象。

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

參數(shù):

參數(shù)名類型必填說明
zondIDstring時區(qū)ID。

返回值:

類型說明
TimeZone時區(qū)ID對應(yīng)的時區(qū)對象。

示例:

var timezone = i18n.getTimeZone();

RelativeTimeFormat8+

getID8+

getID(): string

獲取時區(qū)對象的ID。

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

返回值:

類型說明
string時區(qū)對象對應(yīng)的時區(qū)ID。

示例:

var timezone = i18n.getTimeZone();
timezone.getID();

getDisplayName8+

getDisplayName(locale?: string, isDST?: boolean): string

獲取時區(qū)對象在指定區(qū)域的表示。

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

參數(shù):

參數(shù)名類型必填說明
localestring區(qū)域ID。
isDSTboolean表示獲取時區(qū)對象的表示時是否考慮夏令時。

返回值:

類型說明
string時區(qū)對象在指定區(qū)域的表示。

示例:

var timezone = i18n.getTimeZone();
timezone.getDisplayName("zh-CN", false);

getRawOffset8+

getRawOffset(): number

獲取時區(qū)對象表示的時區(qū)與UTC時區(qū)的偏差。

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

返回值:

類型說明
number時區(qū)對象表示的時區(qū)與UTC時區(qū)的偏差。

示例:

var timezone = i18n.getTimeZone();
timezone.getRawOffset();

getOffset8+

getOffset(date?: number): number

獲取某一時刻時區(qū)對象表示的時區(qū)與UTC時區(qū)的偏差。

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

返回值:

類型說明HarmonyOSOpenHarmony鴻蒙文檔籽料:mau123789是v直接拿
number某一時刻時區(qū)對象表示的時區(qū)與UTC時區(qū)的偏差。

搜狗高速瀏覽器截圖20240326151450.png
示例:

var timezone = i18n.getTimeZone();
timezone.getOffset(1234567890);

審核編輯 黃宇

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

    關(guān)注

    33

    文章

    8611

    瀏覽量

    151247
  • 資源
    +關(guān)注

    關(guān)注

    0

    文章

    59

    瀏覽量

    17797
  • 鴻蒙
    +關(guān)注

    關(guān)注

    57

    文章

    2358

    瀏覽量

    42876
收藏 人收藏

    評論

    相關(guān)推薦

    鴻蒙OS開發(fā):【一次開發(fā),多端部署】(資源管理器)解析

    ,使用[@ohos.resourceManager.d.ts] 中的接口,展示了格式字符串查詢、基于指定屏幕分辨率查詢媒體資源、獲取系統(tǒng)資源管理
    的頭像 發(fā)表于 05-21 15:59 ?1084次閱讀
    <b class='flag-5'>鴻蒙</b>OS<b class='flag-5'>開發(fā)</b>:【一次<b class='flag-5'>開發(fā)</b>,多端部署】(<b class='flag-5'>資源管理</b>器)解析

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

    Intl模塊包含國際化能力基礎(chǔ)接口(在ECMA 402中定義)。
    的頭像 發(fā)表于 06-03 09:28 ?892次閱讀
    <b class='flag-5'>鴻蒙</b><b class='flag-5'>開發(fā)</b><b class='flag-5'>接口</b><b class='flag-5'>資源管理</b>:【@<b class='flag-5'>ohos</b>.intl (<b class='flag-5'>國際化</b>-Intl)】

    鴻蒙開發(fā)接口資源管理:【@ohos.resourceManager (資源管理)】

    資源管理模塊,根據(jù)當(dāng)前configuration(語言,區(qū)域,橫豎屏,mccmnc)和device capability(設(shè)備類型,分辨率)提供獲取應(yīng)用資源信息讀取接口。
    的頭像 發(fā)表于 06-03 15:10 ?1144次閱讀
    <b class='flag-5'>鴻蒙</b><b class='flag-5'>開發(fā)</b><b class='flag-5'>接口</b><b class='flag-5'>資源管理</b>:【@<b class='flag-5'>ohos</b>.resourceManager (<b class='flag-5'>資源管理</b>)】

    HarmonyOS全球設(shè)計(jì)指南

    `產(chǎn)品和應(yīng)用要在全球發(fā)布,需考慮全球流程,即“國際化”和“本地”。國際化簡稱「i18n」,是一種趨同的設(shè)計(jì)方式,通過一種方案去滿足不同國
    發(fā)表于 09-24 17:21

    長虹N2518/25N18彩電電路圖

    長虹N2518/25N18彩色電視機(jī)電路圖,長虹N2518/25N18彩電圖紙,長虹N2518/25N1
    發(fā)表于 05-05 16:41 ?376次下載
    長虹<b class='flag-5'>N</b>2518/25<b class='flag-5'>N18</b>彩電電路圖

    WCDMA無線資源管理

    本課程介紹了無線資源管理的相關(guān)知識。首先通過對無線資源管理的總體介紹,讓大家對無線資源管理有了一個大體上的概念接著對無線資源管理的幾個方面:信道配置、
    發(fā)表于 06-01 16:02 ?5次下載

    使用MSSP模塊進(jìn)行I2C串行EEPROM與PIC18器件的接口設(shè)計(jì)

    使用MSSP模塊進(jìn)行I2C串行EEPROM與PIC18器件的接口設(shè)計(jì)說明。
    發(fā)表于 05-11 10:23 ?11次下載

    擬態(tài)通用運(yùn)行環(huán)境的資源管理調(diào)度及框架

    資源管理與調(diào)度等方面論述擬態(tài)資源管理服務(wù)與調(diào)度算法的設(shè)計(jì)與實(shí)現(xiàn),構(gòu)造擬態(tài)運(yùn)行節(jié)點(diǎn)軟硬件資源異構(gòu)特征分類器及基于三級異構(gòu)度分類的節(jié)點(diǎn)N元組和N
    發(fā)表于 05-12 11:20 ?6次下載

    CAT-D38999-DTS18I CAT-D38999-DTS18I 標(biāo)準(zhǔn)圓形連接器

    電子發(fā)燒友網(wǎng)為你提供TE(ti)CAT-D38999-DTS18I相關(guān)產(chǎn)品參數(shù)、數(shù)據(jù)手冊,更有CAT-D38999-DTS18I的引腳圖、接線圖、封裝手冊、中文資料、英文資料,CAT-D38999-DTS18I真值表,CAT-D
    發(fā)表于 07-30 23:00

    采用 I2PAK 封裝的 NextPower 100V,18N溝道 MOSFET-PSMN018-100ESF

    采用 I2PAK 封裝的 NextPower 100 V、18N 溝道 MOSFET-PSMN018-100ESF
    發(fā)表于 02-23 18:45 ?0次下載
    采用 <b class='flag-5'>I</b>2PAK 封裝的 NextPower 100V,<b class='flag-5'>18</b> mΩ<b class='flag-5'>N</b>溝道 MOSFET-PSMN018-100ESF

    SpringBoot參數(shù)驗(yàn)證的10個技巧2

    如果你的應(yīng)用程序支持多種語言,則必須使用國際化 (i18n) 以用戶首選語言顯示錯誤消息。 以下是在 Spring Boot 應(yīng)用程序中使用 i18n 處理錯誤消息的示例
    的頭像 發(fā)表于 04-07 15:11 ?1400次閱讀

    GOFORD 18N10(HD)

    GOFORD18N10(HD)
    發(fā)表于 12-01 10:50 ?0次下載

    鴻蒙實(shí)戰(zhàn)開發(fā):【國際化部件】

    **國際化部件**為應(yīng)用提供了一系列國際化接口,包括:時間日期格式、數(shù)字格式、月份星期格式
    的頭像 發(fā)表于 03-21 22:07 ?325次閱讀
    <b class='flag-5'>鴻蒙</b>實(shí)戰(zhàn)<b class='flag-5'>開發(fā)</b>:【<b class='flag-5'>國際化</b>部件】

    OpenHarmony實(shí)例:【資源管理器】

    ,使用[@ohos.resourceManager.d.ts]中的接口,展示了格式字符串查詢、基于指定屏幕分辨率查詢媒體資源、獲取系統(tǒng)資源管理
    的頭像 發(fā)表于 04-09 15:10 ?476次閱讀
    OpenHarmony實(shí)例:【<b class='flag-5'>資源管理</b>器】

    18N70友順UTC 18A, 700V ,N通道 功率場效應(yīng)晶體管

    UTC 18N70-HC是一個n通道增強(qiáng)型MOSFET采用聯(lián)合技術(shù)的先進(jìn)技術(shù)為客戶提供完美的rds (ON),高開關(guān)速度,大電流容量和低功耗門。UTC 18N70-HC普遍應(yīng)用于低電壓,如汽車,AC
    發(fā)表于 07-03 15:29 ?0次下載