diff --git a/zh-cn/application-dev/internationalization/intl-guidelines.md b/zh-cn/application-dev/internationalization/intl-guidelines.md index eef2fc94f09a6c39278a41da006deeef450213b6..be0738803e7bafb4b3cac82eb4edff095765c215 100644 --- a/zh-cn/application-dev/internationalization/intl-guidelines.md +++ b/zh-cn/application-dev/internationalization/intl-guidelines.md @@ -28,7 +28,7 @@ Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方 - 语言:必选,使用2个或3个小写英文字母表示(可参考ISO-639标准),例如英文使用“en”表示,中文使用“zh”表示。 - 脚本:可选,使用4个英文字母表示,其中首字母需要大写,后面3个使用小写字母(可参考ISO-15924)。例如,中文繁体使用脚本“Hant”表示,中文简体使用脚本“Hans”表示。 - 国家或地区:可选,使用两个大写字母表示(可参考ISO-3166),例如中国使用“CN”表示,美国使用“US”表示; - - 扩展参数:可选,由key和value两部分组成,目前支持以下扩展参数(可参考BCP 47扩展)。各个扩展参数之间没有严格的顺序,使用“-key-value”的格式书写。扩展参数整体使用“-u”连接到语言、脚本、地区后面。例如“zh-u-nu-latn-ca-chinese”表示使用“latn”数字系统,使用“chinese”日历系统、“latn”数字系统。扩展参数也可以通过第二个参数传入。 + - 扩展参数:可选,由key和value两部分组成,目前支持以下扩展参数(可参考BCP 47扩展)。各个扩展参数之间没有严格的顺序,使用“-key-value”的格式书写。扩展参数整体使用“-u”连接到语言、脚本、地区后面。例如“zh-u-nu-latn-ca-chinese”表示使用“latn”数字系统,“chinese”日历系统。扩展参数也可以通过第二个参数传入。 | 扩展参数ID | 扩展参数说明 | | -------- | -------- | | ca | 表示日历系统 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-i18n.md b/zh-cn/application-dev/reference/apis/js-apis-i18n.md index a51d86d32950ee361292e85bf116be0aad10f3cb..521ae7e4071c393137633667ea7cedaeb5ec4169 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-i18n.md +++ b/zh-cn/application-dev/reference/apis/js-apis-i18n.md @@ -115,14 +115,13 @@ getSystemLanguage(): string setSystemLanguage(language: string): boolean -设置系统语言。 +设置系统语言。
+该接口为系统接口。 **需要权限**:ohos.permission.UPDATE_CONFIGURATION **系统能力**:SystemCapability.Global.I18n -**系统API**: 该接口为系统接口,三方应用不支持调用。 - **参数:** | 参数名 | 类型 | 说明 | | -------- | ------ | ----- | @@ -209,14 +208,13 @@ getSystemRegion(): string setSystemRegion(region: string): boolean -设置系统区域。 +设置系统区域。
+该接口为系统接口。 **需要权限**:ohos.permission.UPDATE_CONFIGURATION **系统能力**:SystemCapability.Global.I18n -**系统API**: 该接口为系统接口,三方应用不支持调用。 - **参数:** | 参数名 | 类型 | 说明 | | ------ | ------ | ----- | @@ -256,14 +254,13 @@ getSystemLocale(): string setSystemLocale(locale: string): boolean -设置系统Locale。 +设置系统Locale。
+该接口为系统接口。 **需要权限**:ohos.permission.UPDATE_CONFIGURATION **系统能力**:SystemCapability.Global.I18n -**系统API**: 该接口为系统接口,三方应用不支持调用。 - **参数:** | 参数名 | 类型 | 说明 | | ------ | ------ | --------------- | @@ -1547,4 +1544,137 @@ getOffset(date?: number): number ``` var timezone = i18n.getTimeZone(); timezone.getOffset(1234567890); + ``` + + +### getAvailableIDs9+ + +static getAvailableIDs(): Array<string> + +获取系统支持的时区ID。 + +**系统能力**:SystemCapability.Global.I18n + +**返回值:** +| 类型 | 说明 | +| ------ | ----------------------- | +| Array<string> | 系统支持的时区ID列表 | + +**示例:** + ``` + var ids = i18n.TimeZone.getAvailableIDs(); + ``` + + +### getAvailableZoneCityIDs9+ + +static getAvailableZoneCityIDs(): Array<string> + +获取系统支持的时区城市ID。 + +**系统能力**:SystemCapability.Global.I18n + +**返回值:** +| 类型 | 说明 | +| ------ | ----------------------- | +| Array<string> | 系统支持的时区城市ID列表 | + +**示例:** + ``` + var cityIDs = i18n.TimeZone.getAvailableZoneCityIDs(); + ``` + + +### getCityDisplayName9+ + +static getCityDisplayName(cityID: string, locale: string): string + +获取某时区城市在locale下的本地化显示。 + +**系统能力**:SystemCapability.Global.I18n + +**参数:** +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ----- | +| cityID | string | 是 | 时区城市ID | +| locale | string | 是 | 区域ID | + +**返回值:** +| 类型 | 说明 | +| ------ | ----------------------- | +| string | 时区城市在locale下的本地化显示 | + +**示例:** + ``` + var displayName = i18n.TimeZone.getCityDisplayName("Shanghai", "zh-CN"); + ``` + + +### getTimezoneFromCity9+ + +static getTimezoneFromCity(cityID: string): TimeZone + +创建某时区城市对应的时区对象。 + +**系统能力**:SystemCapability.Global.I18n + +**参数:** +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ----- | +| cityID | string | 是 | 时区城市ID | + +**返回值:** +| 类型 | 说明 | +| ------ | ----------------------- | +| TimeZone | 时区城市对应的时区对象 | + +**示例:** + ``` + var timezone = i18n.TimeZone.getTimezoneFromCity("Shanghai"); + ``` + + +## i18n.setUsingLocalDigit9+ + +setUsingLocalDigit(flag: boolean): boolean + +设置是否打开本地数字开关。
+该接口为系统接口。 + +**需要权限**:ohos.permission.UPDATE_CONFIGURATION + +**系统能力**:SystemCapability.Global.I18n + +**参数:** +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ----- | +| flag | boolean | 是 | true表示打开本地数字开关,false表示关闭本地数字开关。 | + +**返回值:** +| 类型 | 说明 | +| -------- | ------------ | +| boolean | true表示本地数字开关设置成功,false表示本地数字开关设置失败。 | + +**示例:** + ``` + var status = i18n.setUsingLocalDigit(true); + ``` + + +## i18n.getUsingLocalDigit9+ + +getUsingLocalDigit(): boolean + +获取系统当前是否打开本地数字开关。 + +**系统能力**:SystemCapability.Global.I18n + +**返回值:** +| 类型 | 说明 | +| -------- | ------------ | +| boolean | true表示系统当前已打开本地数字开关,false表示系统当前未打开本地数字开关。 | + +**示例:** + ``` + var status = i18n.getUsingLocalDigit(); ``` \ No newline at end of file