!6132 增加时区数据列表和本地数字开关接口

Merge pull request !6132 from sunyaozu/master

zh-cn/application-dev/internationalization/intl-guidelines.md

@@ -29,7 +29,7 @@
    -  语言：必选，使用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 | 表示日历系统 |

zh-cn/application-dev/reference/apis/js-apis-i18n.md

@@ -115,14 +115,13 @@ getSystemLanguage(): string
 
 setSystemLanguage(language: string): boolean
 
-设置系统语言。
+设置系统语言。<br>
+该接口为系统接口。
 
 **需要权限**：ohos.permission.UPDATE_CONFIGURATION
 
 **系统能力**：SystemCapability.Global.I18n
 
-**系统API**: 该接口为系统接口，三方应用不支持调用。
-
 **参数：** 
 | 参数名      | 类型     | 说明    |
 | -------- | ------ | ----- |
@@ -209,14 +208,13 @@ getSystemRegion(): string
 
 setSystemRegion(region: string): boolean
 
-设置系统区域。
+设置系统区域。<br>
+该接口为系统接口。
 
 **需要权限**：ohos.permission.UPDATE_CONFIGURATION
 
 **系统能力**：SystemCapability.Global.I18n
 
-**系统API**: 该接口为系统接口，三方应用不支持调用。
-
 **参数：** 
 | 参数名    | 类型     | 说明    |
 | ------ | ------ | ----- |
@@ -256,14 +254,13 @@ getSystemLocale(): string
 
 setSystemLocale(locale: string): boolean
 
-设置系统Locale。
+设置系统Locale。<br>
+该接口为系统接口。 
 
 **需要权限**：ohos.permission.UPDATE_CONFIGURATION
 
 **系统能力**：SystemCapability.Global.I18n
 
-**系统API**: 该接口为系统接口，三方应用不支持调用。
-
 **参数：** 
 | 参数名    | 类型     | 说明              |
 | ------ | ------ | --------------- |
@@ -1547,4 +1544,137 @@ getOffset(date?: number): number
   ```
   var timezone = i18n.getTimeZone();
   timezone.getOffset(1234567890);
+  ```
+
+
+### getAvailableIDs<sup>9+</sup>
+
+static getAvailableIDs(): Array&lt;string&gt;
+
+获取系统支持的时区ID。
+
+**系统能力**：SystemCapability.Global.I18n
+
+**返回值：** 
+| 类型     | 说明                      |
+| ------ | ----------------------- |
+| Array&lt;string&gt; | 系统支持的时区ID列表 |
+
+**示例：** 
+  ```
+  var ids = i18n.TimeZone.getAvailableIDs();
+  ```
+
+
+### getAvailableZoneCityIDs<sup>9+</sup>
+
+static getAvailableZoneCityIDs(): Array&lt;string&gt;
+
+获取系统支持的时区城市ID。
+
+**系统能力**：SystemCapability.Global.I18n
+
+**返回值：** 
+| 类型     | 说明                      |
+| ------ | ----------------------- |
+| Array&lt;string&gt; | 系统支持的时区城市ID列表 |
+
+**示例：** 
+  ```
+  var cityIDs = i18n.TimeZone.getAvailableZoneCityIDs();
+  ```
+
+
+### getCityDisplayName<sup>9+</sup>
+
+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");
+  ```
+
+
+### getTimezoneFromCity<sup>9+</sup>
+
+static getTimezoneFromCity(cityID: string): TimeZone
+
+创建某时区城市对应的时区对象。
+
+**系统能力**：SystemCapability.Global.I18n
+
+**参数：** 
+| 参数名    | 类型     | 必填   | 说明    |
+| ------ | ------ | ---- | ----- |
+| cityID | string | 是    | 时区城市ID |
+
+**返回值：** 
+| 类型     | 说明                      |
+| ------ | ----------------------- |
+| TimeZone | 时区城市对应的时区对象 |
+
+**示例：** 
+  ```
+  var timezone = i18n.TimeZone.getTimezoneFromCity("Shanghai");
+  ```
+
+
+## i18n.setUsingLocalDigit<sup>9+</sup>
+
+setUsingLocalDigit(flag: boolean): boolean
+
+设置是否打开本地数字开关。<br>
+该接口为系统接口。
+
+**需要权限**：ohos.permission.UPDATE_CONFIGURATION
+
+**系统能力**：SystemCapability.Global.I18n
+
+**参数：** 
+| 参数名    | 类型     | 必填   | 说明    |
+| ------ | ------ | ---- | ----- |
+| flag | boolean | 是    | true表示打开本地数字开关，false表示关闭本地数字开关。 |
+
+**返回值：** 
+| 类型       | 说明           |
+| -------- | ------------ |
+| boolean | true表示本地数字开关设置成功，false表示本地数字开关设置失败。 |
+
+**示例：** 
+  ```
+  var status = i18n.setUsingLocalDigit(true);
+  ```
+
+
+## i18n.getUsingLocalDigit<sup>9+</sup>
+
+getUsingLocalDigit(): boolean
+
+获取系统当前是否打开本地数字开关。
+
+**系统能力**：SystemCapability.Global.I18n
+
+**返回值：** 
+| 类型       | 说明           |
+| -------- | ------------ |
+| boolean | true表示系统当前已打开本地数字开关，false表示系统当前未打开本地数字开关。 |
+
+**示例：** 
+  ```
+  var status = i18n.getUsingLocalDigit();
   ```
\ No newline at end of file