鸿蒙开发接口资源管理：【@ohos.i18n (国际化-I18n)】

国际化-I18n

icon-note.gif

 说明：
开发前请熟悉鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

  • 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
  • I18N模块包含国际化能力增强接口（未在ECMA 402中定义）。

导入模块

import i18n from '@ohos.i18n';

i18n.getDisplayLanguage

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

获取指定语言的本地化显示文本。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
languagestring是指定语言。
localestring是显示指定语言的区域ID。
sentenceCaseboolean否本地化显示文本是否要首字母大写。

返回值：

类型说明
string指定语言的本地化显示文本。

示例：

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

i18n.getDisplayCountry

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

获取指定国家的本地化显示文本。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
countrystring是指定国家。
localestring是显示指定国家的区域ID。
sentenceCaseboolean否本地化显示文本是否要首字母大写。

返回值：

类型说明
string指定国家的本地化显示文本。

示例：

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

i18n.isRTL7+

isRTL(locale: string): boolean

获取是否为从右至左显示语言。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型说明
localestring指定区域ID。

返回值：

类型说明
booleantrue表示该locale从右至左显示语言；false表示该locale从左至右显示语言。

示例：

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

i18n.getSystemLanguage

getSystemLanguage(): string

获取系统语言。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
string系统语言ID。

示例：

i18n.getSystemLanguage();

i18n.setSystemLanguage

setSystemLanguage(language: string): boolean

设置系统语言。

需要权限：ohos.permission.UPDATE_CONFIGURATION

系统能力：SystemCapability.Global.I18n

系统API: 该接口为系统接口，三方应用不支持调用。

参数：

参数名类型说明
languagestring语言ID。

返回值：

类型说明
boolean返回true，表示系统语言设置成功；返回false，表示系统语言设置失败。

示例：

i18n.setSystemLanguage('zh');

i18n.getSystemLanguages

getSystemLanguages(): Array<string>

获取系统支持的语言列表。

系统能力：SystemCapability.Global.I18n

系统API: 该接口为系统接口，三方应用不支持调用。

返回值：

类型说明
Array<string>系统支持的语言ID列表。

示例：

i18n.getSystemLanguages();

i18n.getSystemCountries

getSystemCountries(language: string): Array<string>

获取针对输入语言系统支持的区域列表。

系统能力：SystemCapability.Global.I18n

系统API: 该接口为系统接口，三方应用不支持调用。

参数：

参数名类型说明
languagestring语言ID。

返回值：

类型说明
Array<string>系统支持的区域ID列表。

示例：

i18n.getSystemCountries('zh');

i18n.getSystemRegion

getSystemRegion(): string

获取系统地区。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
string系统地区ID。

示例：

i18n.getSystemRegion();

i18n.setSystemRegion

setSystemRegion(region: string): boolean

设置系统区域。

需要权限：ohos.permission.UPDATE_CONFIGURATION

系统能力：SystemCapability.Global.I18n

系统API: 该接口为系统接口，三方应用不支持调用。

参数：

参数名类型说明
regionstring地区ID。

返回值：

类型说明
boolean返回true，表示系统区域设置成功；返回false，表示系统区域设置失败。

示例：

i18n.setSystemRegion('CN');

i18n.getSystemLocale

getSystemLocale(): string

获取系统区域。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
string系统区域ID。

示例：

i18n.getSystemLocale();

i18n.setSystemLocale

setSystemLocale(locale: string): boolean

设置系统Locale。

需要权限：ohos.permission.UPDATE_CONFIGURATION

系统能力：SystemCapability.Global.I18n

系统API: 该接口为系统接口，三方应用不支持调用。

参数：

参数名类型说明
localestring指定区域ID，例如zh-CN。

返回值：

类型说明
boolean返回true，表示系统Locale设置成功；返回false，表示系统Locale设置失败。

示例：

i18n.setSystemLocale('zh-CN');

i18n.isSuggested

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

判断当前语言和区域是否匹配。

系统能力：SystemCapability.Global.I18n

系统API: 该接口为系统接口，三方应用不支持调用。

参数：

参数名类型必填说明
languagestring是合法的语言ID，例如zh。
regionstring否合法的地区ID，例如CN

返回值：

类型说明
boolean返回true，表示当前语言和地区匹配；返回false，表示当前语言和地区不匹配。

示例：

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

i18n.getCalendar8+

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

获取日历对象。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
localestring是合法的locale值，例如zh-Hans-CN。
typestring否合法的日历类型，目前合法的类型有buddhist, chinese, coptic, ethiopic, hebrew, gregory, indian, islamic_civil, islamic_tbla, islamic_umalqura, japanese, persian。当type没有给出时，采用区域默认的日历类型。

返回值：

类型说明
[Calendar]日历对象。

示例：

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

Calendar8+

setTime8+

setTime(date: Date): void

设置日历对象内部的时间日期。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
dateDate是将要设置的日历对象的内部时间日期。

示例：

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

设置日历对象内部的时间日期, time为从1970.1.1 00:00:00 GMT逝去的毫秒数。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
timenumber是time为从1970.1.1 00:00:00 GMT逝去的毫秒数。

示例：

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

设置日历对象的年、月、日、时、分、秒。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
yearnumber是设置的年。
monthnumber是设置的月。
datenumber是设置的日。
hournumber否设置的小时。
minutenumber否设置的分钟。
secondnumber否设置的秒。

示例：

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

设置日历对象的时区。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
timezonestring是设置的时区id，如“Asia/Shanghai”。

示例：

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

getTimeZone8+

getTimeZone(): string

获取日历对象的时区。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
string日历对象的时区id。

示例：

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

getFirstDayOfWeek8+

getFirstDayOfWeek(): number

获取日历对象的一周起始日。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
number获取一周的起始日，1代表周日，7代表周六。

示例：

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

setFirstDayOfWeek8+

setFirstDayOfWeek(value: number): void

设置每一周的起始日。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
valuenumber否设置一周的起始日，1代表周日，7代表周六。

示例：

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

getMinimalDaysInFirstWeek8+

getMinimalDaysInFirstWeek(): number

获取一年中第一周的最小天数。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
number一年中第一周的最小天数。

示例：

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

setMinimalDaysInFirstWeek8+

setMinimalDaysInFirstWeek(value: number): void

设置一年中第一周的最小天数。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
valuenumber否一年中第一周的最小天数。

示例：

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

get8+

get(field: string): number

获取日历对象中与field相关联的值。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
fieldstring是通过field来获取日历对象相应的值。目前支持的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相关联的值，如当前Calendar对象的内部日期的年份为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所指定的区域的名字。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
localestring是locale指定获取哪个区域下该calendar的名字，如buddhist在en-US上显示的名称为“Buddhist Calendar”。

返回值：

类型说明
string日历在locale所指示的区域的名字。

示例：

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

isWeekend8+

isWeekend(date?: Date): boolean

判断给定的日期是否在日历中是周末。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
dateDate否判断日期在日历中是否是周末。如果date没有给出，判断calendar当前日期是否为周末。

返回值：

类型说明
boolean当所判断的日期为周末时，返回 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)

创建电话号码格式化对象。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
countrystring是表示电话号码所属国家或地区代码。
options[PhoneNumberFormatOptions]否电话号码格式化对象的相关选项。

示例：

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

isValidNumber8+

isValidNumber(number: string): boolean

判断传入的电话号码格式是否正确。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
numberstring是待判断的电话号码。

返回值：

类型说明
boolean返回true表示电话号码的格式正确，返回false表示电话号码的格式错误。

示例：

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

format8+

format(number: string): string

对电话号码进行格式化。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
numberstring是待格式化的电话号码。

返回值：

类型说明
string格式化后的电话号码。

示例：

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

PhoneNumberFormatOptions8+

表示电话号码格式化对象可设置的属性。

系统能力：以下各项对应的系统能力均为SystemCapability.Global.I18n

名称参数类型可读可写说明
typestring是是表示对电话号码格式化的类型，取值范围："E164", "INTERNATIONAL", "NATIONAL", "RFC3966"。

UnitInfo8+

度量衡单位信息。

系统能力：以下各项对应的系统能力均为SystemCapability.Global.I18n

名称参数类型可读可写说明
unitstring是是单位的名称，如："meter", "inch", "cup"等。
measureSystemstring是是单位的度量体系，取值包括："SI", "US", "UK"。

Util8+

unitConvert8+

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

将fromUnit的单位转换为toUnit的单位，并根据区域与风格进行格式化。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
fromUnit[UnitInfo]是要被转换的单位。
toUnit[UnitInfo]是要转换为的单位。
valuenumber是要被转换的单位的数量值。
localestring是格式化时使用的区域参数，如：zh-Hans-CN。
stylestring否格式化使用的风格，取值包括："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

创建并返回IndexUtil对象。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
localestring否包含区域设置信息的字符串，包括语言以及可选的脚本和区域。

返回值：

类型说明
[IndexUtil]locale对应的IndexUtil对象。

示例：

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

IndexUtil8+

getIndexList8+

getIndexList(): Array<string>

获取当前locale对应的索引列表。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
Array<string>返回当前locale对应的索引列表。

示例：

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

addLocale8+

addLocale(locale: string): void

将新的locale对应的索引加入当前索引列表。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
localestring是包含区域设置信息的字符串，包括语言以及可选的脚本和区域。

示例：

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

getIndex8+

getIndex(text: string): string

获取text对应的索引。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
textstring是待计算索引值的输入文本。

返回值：

类型说明
string输入文本对应的索引值。

示例：

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

Character8+

isDigit8+

isDigit(char: string): boolean

判断字符串char是否是数字。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
charstring是输入字符。

返回值：

类型说明
boolean返回true表示输入的字符是数字，返回false表示输入的字符不是数字。

示例：

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

isSpaceChar8+

isSpaceChar(char: string): boolean

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

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
charstring是输入字符。

返回值：

类型说明
boolean返回true表示输入的字符是空格符，返回false表示输入的字符不是空格符。

示例：

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

isWhitespace8+

isWhitespace(char: string): boolean

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

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
charstring是输入字符。

返回值：

类型说明
boolean返回true表示输入的字符是空白符，返回false表示输入的字符不是空白符。

示例：

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

isRTL8+

isRTL(char: string): boolean

判断字符串char是否是从右到左语言的字符。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
charstring是输入字符。

返回值：

类型说明
boolean返回true表示输入的字符是从右到左语言的字符，返回false表示输入的字符不是从右到左语言的字符。

示例：

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

isIdeograph8+

isIdeograph(char: string): boolean

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

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
charstring是输入字符。

返回值：

类型说明
boolean返回true表示输入的字符是表意文字，返回false表示输入的字符不是表意文字。

示例：

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

isLetter8+

isLetter(char: string): boolean

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

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
charstring是输入字符。

返回值：

类型说明
boolean返回true表示输入的字符是字母，返回false表示输入的字符不是字母。

示例：

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

isLowerCase8+

isLowerCase(char: string): boolean

判断字符串char是否是小写字母。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
charstring是输入字符。

返回值：

类型说明
boolean返回true表示输入的字符是小写字母，返回false表示输入的字符不是小写字母。

示例：

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

isUpperCase8+

isUpperCase(char: string): boolean

判断字符串char是否是大写字母。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
charstring是输入字符。

返回值：

类型说明
boolean返回true表示输入的字符是大写字母，返回false表示输入的字符不是大写字母。

示例：

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

getType8+

getType(char: string): string

获取输入字符串的一般类别值。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
charstring是输入字符。

返回值：

类型说明
string输入字符的一般类别值。

示例：

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

i18n.getLineInstance8+

getLineInstance(locale: string): BreakIterator

获取一个用于断句的[BreakIterator]对象。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
localestring是合法的locale值，例如zh-Hans-CN。生成的[BreakIterator]将按照locale所指定的区域的规则来进行断句。

返回值：

类型说明
[BreakIterator]用于进行断句的处理器。

示例：

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

BreakIterator8+

setLineBreakText8+

setLineBreakText(text: string): void

设置[BreakIterator]要处理的文本。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
textstring是指定BreakIterator进行断句的文本。

示例：

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

getLineBreakText8+

getLineBreakText(): string

获取[BreakIterator]当前处理的文本。

系统能力：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]对象在当前处理的文本中的位置。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
numberBreakIterator在当前所处理的文本中的位置。

示例：

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

first8+

first(): number

将[BreakIterator]对象设置到第一个可断句的分割点。第一个分割点总是被处理的文本的起始位置。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
number被处理文本的第一个分割点的偏移量。

示例：

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

last8+

last(): number

将[BreakIterator]对象的位置设置到最后一个可断句的分割点。最后一个分割点总是被处理文本末尾的下一个位置。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
number被处理的文本的最后一个分割点的偏移量

示例：

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

next8+

next(index?: number): number

如果index给出，并且index是一个正数将[BreakIterator]向后移动number个可断句的分割点，如果n是一个负数，向前移动相应个分割点。若index没有给出，则相当于index = 1。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
indexnumber否[BreakIterator]将要移动的分割点数，正数代表向后移动，负数代表向前移动。若index没有给出，则按照index=1处理。

返回值：

类型说明
number返回移动了index个分割点后，当前[BreakIterator]在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-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]移动到前一个分割点处。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
number返回移动到前一个分割点后，当前[BreakIterator]在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-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]设置到由offset指定的位置的后面一个分割点。返回移动后[BreakIterator]的位置。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
offsetnumber是将[BreakIterator]对象的位置设置到由offset所指定的位置的下一个分割点。

返回值：

类型说明
number返回[BreakIterator]移动后的位置，如果由offset所指定的位置的下一个分割点超出了文本的范围则返回-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所指定的文本位置是一个分割点，那么返回true，否则返回false。如果返回true, 将[BreakIterator]对象设置到offset所指定的位置, 否则相当于调用[following]。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
offsetnumber是指定需要进行判断的位置

返回值：

类型说明
boolean如果是一个分割点返回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

判断系统时间是否为24小时制。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
boolean返回true，表示系统24小时开关开启；返回false，表示系统24小时开关关闭。

示例：

var is24HourClock = i18n.is24HourClock();

i18n.set24HourClock7+

set24HourClock(option: boolean): boolean

修改系统时间的24小时制设置。

需要权限：ohos.permission.UPDATE_CONFIGURATION

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
optionboolean是option为true，表示开启系统24小时制开关；返回false，表示关闭系统24小时开关。

返回值：

类型说明
boolean返回true，表示修改成功；返回false，表示修改失败。

示例：

// 将系统时间设置为24小时制
var success = i18n.set24HourClock(true);

i18n.addPreferredLanguage8+

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

在系统偏好语言列表中的指定位置添加偏好语言。

需要权限：ohos.permission.UPDATE_CONFIGURATION

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
languagestring是待添加的偏好语言。
indexnumber否偏好语言的添加位置。

返回值：

类型说明
boolean返回true，表示添加成功；返回false，表示添加失败。

示例：

// 将语言zh-CN添加到系统偏好语言列表中
var language = 'zh-CN';
var index = 0;
var success = i18n.addPreferredLanguage(language, index);

i18n.removePreferredLanguage8+

removePreferredLanguage(index: number): boolean

删除系统偏好语言列表中指定位置的偏好语言。

需要权限：ohos.permission.UPDATE_CONFIGURATION

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
indexnumber是待删除偏好语言在系统偏好语言列表中的位置。

返回值：

类型说明
boolean返回true，表示删除成功；返回false，表示删除失败。

示例：

// 删除系统偏好语言列表中的第一个偏好语言
var index = 0;
var success = i18n.removePreferredLanguage(index);

i18n.getPreferredLanguageList8+

getPreferredLanguageList(): Array<string>

获取系统偏好语言列表。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
Array<string>系统偏好语言列表。

示例：

var preferredLanguageList = i18n.getPreferredLanguageList();

i18n.getFirstPreferredLanguage8+

getFirstPreferredLanguage(): string

获取偏好语言列表中的第一个偏好语言。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
string偏好语言列表中的第一个语言。

示例：

var firstPreferredLanguage = i18n.getFirstPreferredLanguage();

i18n.getAppPreferredLanguage9+

getAppPreferredLanguage(): string

获取应用的偏好语言。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
string应用的偏好语言。

示例：

var appPreferredLanguage = i18n.getAppPreferredLanguage();

i18n.getTimeZone7+

getTimeZone(zoneID?: string): TimeZone

获取时区ID对应的时区对象。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
zondIDstring否时区ID。

返回值：

类型说明
TimeZone时区ID对应的时区对象。

示例：

var timezone = i18n.getTimeZone();

RelativeTimeFormat8+

getID8+

getID(): string

获取时区对象的ID。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
string时区对象对应的时区ID。

示例：

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

getDisplayName8+

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

获取时区对象在指定区域的表示。

系统能力：SystemCapability.Global.I18n

参数：

参数名类型必填说明
localestring否区域ID。
isDSTboolean否表示获取时区对象的表示时是否考虑夏令时。

返回值：

类型说明
string时区对象在指定区域的表示。

示例：

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

getRawOffset8+

getRawOffset(): number

获取时区对象表示的时区与UTC时区的偏差。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明
number时区对象表示的时区与UTC时区的偏差。

示例：

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

getOffset8+

getOffset(date?: number): number

获取某一时刻时区对象表示的时区与UTC时区的偏差。

系统能力：SystemCapability.Global.I18n

返回值：

类型说明 HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿
number某一时刻时区对象表示的时区与UTC时区的偏差。

搜狗高速浏览器截图20240326151450.png


示例：

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

2024年，已有许多程序员把未来投向了鸿蒙开发，想必也在网上寻找过【鸿蒙学习资料】，然而搜索到的资料都是七零八碎比较杂乱，对于新入门的人来说增加了时间成本；为了避免大家在学习过程中浪费过多时间。对此录制了一套鸿蒙基础进阶视频（HarmonyOS NEXT）开发入门&实战教学视频（200集+）发放给大家。↓↓↓点击即可

《鸿蒙 (HarmonyOS NEXT)开发入门&实战教学视频》

《鸿蒙ArkTS语言》

《鸿蒙ArkUI声明式》

《鸿蒙开发环境搭建》

另外还根据鸿蒙官方发布的文档结合华为内部人员分享，经过反复修改整理得出的一整套鸿蒙（HarmonyOS NEXT）学习手册（共计2000页+）想要鸿蒙进阶文档的开发者有福了！

内容包含了：（ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、鸿蒙南向开发、鸿蒙项目实战）等技术知识点。帮助大家在学习鸿蒙路上少走弯路！点击即可↓↓↓

《鸿蒙 (HarmonyOS NEXT)开发基础与实战手册》

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：/a/672162.html

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

寄存器、缓存、内存(虚拟、物理地址)、DDR、RAM的关系

寄存器、缓存、内存(虚拟、物理地址)、DDR、RAM的关系

寄存器、缓存、内存、DDR、RAM的关系 1. 主要概念内部存储器&#xff1a;2.1 寄存器&#xff0c;register2.2 主存储器&#xff0c;内存&#xff0c;memory2.3 缓存&#xff0c;高速缓冲存储器&#xff0c;cache 外部存储器2.4 快闪存储器&#xff0c;闪存&#xff0c;flash Me…
阅读更多...
快手游戏《无尽梦回》官宣开测：热血动作肉鸽来袭

快手游戏《无尽梦回》官宣开测：热血动作肉鸽来袭

易采游戏网最新消息&#xff1a;5月30日11:00&#xff0c;快手自研的梦境主题动作冒险手游《无尽梦回》正式宣布开启测试。此次测试名为“肉鸽进化实验”&#xff0c;旨在测试多角色技能交会的玩法。游戏将开放32人同局竞技&#xff0c;让玩家在激烈的战斗中角逐出唯一的胜利者…
阅读更多...
Go语言之GORM框架(四)——预加载，关联标签与多态关联，自定义数据类型与事务(完结篇)

Go语言之GORM框架(四)——预加载，关联标签与多态关联，自定义数据类型与事务(完结篇)

前言 本来是想着写多表关系的&#xff0c;不过写了一半发现重复的部分太多了&#xff0c;想了想与其做一些重复性工作&#xff0c;不如把一些当时觉得抽象的东西记录一下&#xff0c;就当用一篇杂记完成专栏的最后一篇文章吧。 预加载 简单示例 预加载主要用于在多表关系中…
阅读更多...
【C/C++】C/C++车辆交通违章管理系统（源码+数据文件）【独一无二】

【C/C++】C/C++车辆交通违章管理系统（源码+数据文件）【独一无二】

&#x1f449;博__主&#x1f448;&#xff1a;米码收割机 &#x1f449;技__能&#x1f448;&#xff1a;C/Python语言 &#x1f449;公众号&#x1f448;&#xff1a;测试开发自动化【获取源码商业合作】 &#x1f449;荣__誉&#x1f448;&#xff1a;阿里云博客专家博主、5…
阅读更多...
数据标准的制定落地

数据标准的制定落地

目录 什么是数据标准 基本定义 目的 数据标准体系分类 从内容层面分类 从管理视角分类 从面向的对象分类 从数据结构的角度分类 数据标准价值 业务价值 技术价值 管理价值 数据标准和数据治理的关系 数据标准在数据治理各项任务中的作用 数据标准与主数据 数据…
阅读更多...
【Linux】中常见的重要指令（下）以及重要的几个热键

【Linux】中常见的重要指令（下）以及重要的几个热键

目录 一、时间相关的指令date 1.时间戳 二、Cal指令 三、find指令 1.whereis 2.which 四、grep指令 五、zip和unzip指令 六、tar指令 七、bc指令 八、重要的几个热键[Tab]&#xff0c;[ctrl]-c&#xff0c;[ctrl]-d 一、时间相关的指令date date 指定格式显示时间&…
阅读更多...
夜天之书 #98 Rust 程序库生态合作的例子

夜天之书 #98 Rust 程序库生态合作的例子

近期主要时间都在适应产品市场&#xff08;Product Marketing&#xff09;的新角色&#xff0c;不少想法还在酝酿和斟酌当中&#xff0c;于是文章输出没有太多时间来推敲和选题&#xff0c;只能保持每月发布相关的进展或一些零碎的思考。或许我可以恢复最早的模式&#xff0c;多…
阅读更多...
node.js点餐系统app-计算机毕业设计源码84406

node.js点餐系统app-计算机毕业设计源码84406

摘 要 21世纪的今天&#xff0c;随着社会的不断发展与进步&#xff0c;人们对于信息科学化的认识&#xff0c;已由低层次向高层次发展&#xff0c;由原来的感性认识向理性认识提高&#xff0c;管理工作的重要性已逐渐被人们所认识&#xff0c;科学化的管理&#xff0c;使信息存…
阅读更多...
脚本实现登陆滑块

脚本实现登陆滑块

脚本实现登陆滑块 仅供学习参考&#xff0c;简单操作 你知道吗&#xff0c;滑动验证码居然是为了验证人类比机器人蠢而设计的。 你以为自己快速、准确地滑动拼图、对齐图案&#xff0c;才被允许通过&#xff0c;系统还说你超越了99%的用户&#xff0c;夸你“比闪电还快”&am…
阅读更多...
算法-随机快排及荷兰国旗优化

算法-随机快排及荷兰国旗优化

文章目录 算法介绍 :1. 随机快排解析2. 荷兰国旗问题3. 随机快排优化4. 总结随机快排 算法介绍 : 随机快速排序和传统的快速排序的逻辑本质是一致的,都是找到一个值作为划分的中间位置,左边数值均小于该数值,右边数值均大于该数值,但是与传统的快排又不一致的是,我们的这个位置…
阅读更多...
Chrome DevTools

Chrome DevTools

Console 面板 此章节请打开 justwe7.github.io/devtools/console/console.html 一起食用 一方面用来记录页面在执行过程中的信息&#xff08;一般通过各种 console 语句来实现&#xff09;&#xff0c;另一方面用来当做 shell 窗口来执行脚本以及与页面文档、DevTools 等进行交…
阅读更多...
动态SQL IF语句

动态SQL IF语句

IF语句学习 第一种写法(标准) 我们先来看以下标准写法: select * from .. <where> <if test""> and ....... <if test""> and ....... <where> 我们用了一个where标签 , 内嵌if语句 第二种写法: 这是第二种写法:不用where标…
阅读更多...
综合交易模型--雪球跟单参数说明支持qmt，同花顺

综合交易模型--雪球跟单参数说明支持qmt，同花顺

经过测试&#xff0c;目前完成了这个策略。支持多策略&#xff0c;支持全市场&#xff0c;包括股票&#xff0c;etf,可转债 全部的参数 { "雪球跟单":"跟单原理", "原理":"比重变大默认买入&#xff0c;变小默认卖出&#xff0c;持股…
阅读更多...
【SpringBoot】SpringBoot项目关于默认port以及context path的配置 application.yml

【SpringBoot】SpringBoot项目关于默认port以及context path的配置 application.yml

application.yml server port [端口号] 配置/修改默认端口号 # server configurationserver:port: 8080context path [虚拟目录] 配置/修改默认虚拟目录 # server configurationserver:servlet:context-path: /spring configuration # spring configuration spring:applica…
阅读更多...
mysql DDL——增删改

mysql DDL——增删改

简略版&#xff1a; 详细版&#xff1a; DDL&#xff1a;对库中表的的记录进行增删改操作&#xff1b; 分别对应&#xff1a;添加&#xff08;insert&#xff09;&#xff0c;修改(update)&#xff0c;删除(delete); 一&#xff1a;添加数据 1. 对全部字段添加数据&#x…
阅读更多...
【一刷《剑指Offer》】面试题 28：字符串的排列

【一刷《剑指Offer》】面试题 28：字符串的排列

牛客对应题目链接&#xff1a;字符串的排列_牛客题霸_牛客网 (nowcoder.com) 力扣对应题目链接&#xff1a;LCR 157. 套餐内商品的排列顺序 - 力扣&#xff08;LeetCode&#xff09; 核心考点 &#xff1a;全排列问题&#xff0c; DFS。 一、《剑指Offer》对应内容 二、分析题…
阅读更多...
关于留痕的使用常见的问题

关于留痕的使用常见的问题

1. 登录微信 登录要导出数据的微信&#xff08;不支持微信多开&#xff0c;不支持部分老版本微信&#xff09; 相关信息 想把手机端的微信聊天记录转移到电脑上可以使用微信自带的聊天记录迁移功能 操作步骤&#xff1a; 安卓&#xff1a; 手机微信->我->设置->聊…
阅读更多...
AI解密：语言模型生成下一个词的概率从何而来

AI解密：语言模型生成下一个词的概率从何而来

在这个信息爆炸的时代&#xff0c;你是否曾好奇过&#xff0c;当你与聊天机器人流畅对话时&#xff0c;那些机智回复的背后&#xff0c;究竟隐藏着怎样的秘密&#xff1f;今天&#xff0c;就让我们一起乘坐时光机&#xff0c;深入语言模型的神秘腹地&#xff0c;揭开它预测下一…
阅读更多...
【spring】第二篇 bean实例化

【spring】第二篇 bean实例化

对象已经能交给Spring的IOC容器来创建了&#xff0c;但是容器是如何来创建对象的呢? 就需要研究下bean的实例化过程&#xff0c;在这块内容中主要解决两部分内容&#xff0c;分别是 bean是如何创建的 实例化bean的三种方式&#xff0c;构造方法,静态工厂和实例工厂 在讲解这…
阅读更多...
iOS——类与对象底层探索

iOS——类与对象底层探索

类和对象的本质 当我们使用OC创建一个testClass类并在main函数创建它的实例对象的时候&#xff0c;OC的底层到底是什么样的呢&#xff1f; 首先&#xff0c;我们要了解OC对象的底层结构&#xff0c;那么我们就得知道&#xff1a;OC本质底层实现转化其实都是C/C代码。 使用下面…
阅读更多...
最新文章

Copyright @ 2022~2023