From b2084b2fbc71ff854e4fc1877a73de42cc78db5d Mon Sep 17 00:00:00 2001 From: sunyaozu Date: Wed, 8 Jun 2022 16:18:19 +0800 Subject: [PATCH] fix i18n and intl docs probem Signed-off-by: sunyaozu --- .../internationalization/i18n-guidelines.md | 6 +++--- .../internationalization/intl-guidelines.md | 16 +++++++++++++++- .../reference/apis/js-apis-i18n.md | 2 +- 3 files changed, 19 insertions(+), 5 deletions(-) diff --git a/zh-cn/application-dev/internationalization/i18n-guidelines.md b/zh-cn/application-dev/internationalization/i18n-guidelines.md index 01bbfe0349..effc9222f9 100644 --- a/zh-cn/application-dev/internationalization/i18n-guidelines.md +++ b/zh-cn/application-dev/internationalization/i18n-guidelines.md @@ -17,7 +17,7 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 | ohos.i18n | isRTL(locale: string): boolean7+ | locale对应的语言是否为从右到左语言。 | | ohos.i18n | is24HourClock(): boolean7+ | 获取当前系统时间是否采用24小时制 | | ohos.i18n | getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): string | 获取语言的本地化表示。 | -| ohos.i18n | getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): string | 获取国家的本地化表示。 | +| ohos.i18n | getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): string | 获取国家名称的本地化表示。 | ### 开发步骤 @@ -70,13 +70,13 @@ I18n开发指导提供了未在ECMA 402中定义的国际化能力接口的使 ``` 7. 获取国家的本地化表示。
- 调用getDisplayCountry方法获取某一国家的本地化表示。其中，country表示待本地化显示的国家，locale表示本地化的Locale，sentenceCase结果是否需要首字母大写。 + 调用getDisplayCountry方法获取某一国家名称的本地化表示。其中，country表示国家码，使用两个大写字母表示（可参考ISO-3166），例如中国使用“CN”表示。locale表示本地化的Locale字符串。sentenceCase表示是否需要将返回结果的首字母大写。 ``` var country = "US"; var locale = "zh-CN"; var sentenceCase = false; - var localizedCountry = i18n.getDisplayCountry(country, locale, sentenceCase); + var localizedCountry = i18n.getDisplayCountry(country, locale, sentenceCase); // 返回 “美国” ``` diff --git a/zh-cn/application-dev/internationalization/intl-guidelines.md b/zh-cn/application-dev/internationalization/intl-guidelines.md index 386b828755..eef2fc94f0 100644 --- a/zh-cn/application-dev/internationalization/intl-guidelines.md +++ b/zh-cn/application-dev/internationalization/intl-guidelines.md @@ -21,9 +21,23 @@ Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方 ### 开发步骤 1. 实例化Locale对象 + 使用Locale的构造函数创建Locale对象，该方法接收一个表示Locale的字符串及可选的[属性](../reference/apis/js-apis-intl.md)列表（intl为导入的模块名）。 - + 表示Locale的字符串参数可以分为以下四部分：语言、脚本、地区、扩展参数。各个部分按照顺序使用中划线“-”进行连接。 + - 语言：必选，使用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”数字系统。扩展参数也可以通过第二个参数传入。 + | 扩展参数ID | 扩展参数说明 | + | -------- | -------- | + | ca | 表示日历系统 | + | co | 表示排序规则 | + | hc | 表示守时惯例 | + | nu | 表示数字系统 | + | kn | 表示字符串排序、比较时是否考虑数字的实际值 | + | kf | 表示字符串排序、比较时是否考虑大小写 | + ``` var locale = "zh-CN"; var options = {caseFirst: false, calendar: "chinese", collation: pinyin}; 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 dadf0ea12f..a51d86d329 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-i18n.md +++ b/zh-cn/application-dev/reference/apis/js-apis-i18n.md @@ -1461,7 +1461,7 @@ getTimeZone(zoneID?: string): TimeZone ``` -## RelativeTimeFormat8+ +## TimeZone8+ ### getID8+ -- GitLab