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 99788574b2994efa1c73fc60b0d890b46f4ee370..a7a6431a597aff5aef567077dc4fc01fdb5118b4 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-i18n.md +++ b/zh-cn/application-dev/reference/apis/js-apis-i18n.md @@ -32,7 +32,7 @@ static getDisplayCountry(country: string, locale: string, sentenceCase?: boolean | ------------ | ------- | ---- | ---------------- | | country | string | 是 | 指定国家。 | | locale | string | 是 | 显示指定国家的区域ID。 | -| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。 | +| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。默认值：true。 | **返回值：** @@ -71,7 +71,7 @@ static getDisplayLanguage(language: string, locale: string, sentenceCase?: boole | ------------ | ------- | ---- | ---------------- | | language | string | 是 | 指定语言。 | | locale | string | 是 | 显示指定语言的区域ID。 | -| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。 | +| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。默认值：true。 | **返回值：** @@ -177,7 +177,7 @@ static isSuggested(language: string, region?: string): boolean | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ------------- | | language | string | 是 | 合法的语言ID，例如zh。 | -| region | string | 否 | 合法的地区ID，例如CN | +| region | string | 否 | 合法的地区ID，例如CN。默认值：使用SIM卡国家或地区。 | **返回值：** @@ -239,7 +239,7 @@ static setSystemLanguage(language: string): void 设置系统语言。当前调用该接口不支持系统界面语言的实时刷新。 -此接口为系统接口。 +**系统接口**：此接口为系统接口。 **需要权限**：ohos.permission.UPDATE_CONFIGURATION @@ -305,7 +305,7 @@ static setSystemRegion(region: string): void 设置系统区域。 -此接口为系统接口。 +**系统接口**：此接口为系统接口。 **需要权限**：ohos.permission.UPDATE_CONFIGURATION @@ -371,7 +371,7 @@ static setSystemLocale(locale: string): void 设置系统Locale。 -此接口为系统接口。 +**系统接口**：此接口为系统接口。 **需要权限**：ohos.permission.UPDATE_CONFIGURATION @@ -435,9 +435,9 @@ static is24HourClock(): boolean static set24HourClock(option: boolean): void -修改系统时间的24小时制设置。 +设置系统时间为24小时。 -此接口为系统接口。 +**系统接口**：此接口为系统接口。 **需要权限**：ohos.permission.UPDATE_CONFIGURATION @@ -473,7 +473,7 @@ static addPreferredLanguage(language: string, index?: number): void 在系统偏好语言列表中的指定位置添加偏好语言。 -此接口为系统接口。 +**系统接口**：此接口为系统接口。 **需要权限**：ohos.permission.UPDATE_CONFIGURATION @@ -484,7 +484,7 @@ static addPreferredLanguage(language: string, index?: number): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ---------- | | language | string | 是 | 待添加的偏好语言。 | -| index | number | 否 | 偏好语言的添加位置。 | +| index | number | 否 | 偏好语言的添加位置。默认值：系统偏好语言列表长度。 | **错误码：** @@ -512,7 +512,7 @@ static removePreferredLanguage(index: number): void 删除系统偏好语言列表中指定位置的偏好语言。 -此接口为系统接口。 +**系统接口**：此接口为系统接口。 **需要权限**：ohos.permission.UPDATE_CONFIGURATION @@ -578,7 +578,7 @@ static getPreferredLanguageList(): Array<string> static getFirstPreferredLanguage(): string -获取偏好语言列表中的第一个偏好语言。 +获取系统偏好语言列表中的第一个偏好语言。 **系统能力**：SystemCapability.Global.I18n @@ -642,7 +642,7 @@ static setUsingLocalDigit(flag: boolean): void 设置系统是否使用本地数字。 -此接口为系统接口。 +**系统接口**：此接口为系统接口。 **需要权限**：ohos.permission.UPDATE_CONFIGURATION @@ -707,7 +707,7 @@ static getUsingLocalDigit(): boolean isRTL(locale: string): boolean -获取是否为从右至左显示语言。 +获取该区域是否为从右至左显示语言。 **系统能力**：SystemCapability.Global.I18n @@ -743,7 +743,7 @@ getCalendar(locale: string, type? : string): Calendar | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ---------------------------------------- | | locale | string | 是 | 合法的locale值，例如zh-Hans-CN。 | -| type | string | 否 | 合法的日历类型，目前合法的类型有buddhist, chinese, coptic, ethiopic, hebrew, gregory, indian, islamic_civil, islamic_tbla, islamic_umalqura, japanese, persian。当type没有给出时，采用区域默认的日历类型。 | +| type | string | 否 | 合法的日历类型，目前合法的类型有buddhist, chinese, coptic, ethiopic, hebrew, gregory, indian, islamic_civil, islamic_tbla, islamic_umalqura, japanese, persian。默认值：区域默认的日历类型。 | **返回值：** @@ -818,9 +818,9 @@ set(year: number, month: number, date:number, hour?: number, minute?: number, se | year | number | 是 | 设置的年。 | | month | number | 是 | 设置的月。 | | date | number | 是 | 设置的日。 | -| hour | number | 否 | 设置的小时。 | -| minute | number | 否 | 设置的分钟。 | -| second | number | 否 | 设置的秒。 | +| hour | number | 否 | 设置的小时。默认值：系统小时。 | +| minute | number | 否 | 设置的分钟。默认值：系统分钟。 | +| second | number | 否 | 设置的秒。默认值：系统秒。 | **示例：** ```js @@ -990,7 +990,7 @@ get(field: string): number getDisplayName(locale: string): string -获取日历对象在locale所指定的区域的名字。 +获取日历对象在该区域的名字。 **系统能力**：SystemCapability.Global.I18n @@ -998,7 +998,7 @@ getDisplayName(locale: string): string | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ---------------------------------------- | -| locale | string | 是 | locale指定获取哪个区域下该calendar的名字，如buddhist在en-US上显示的名称为“Buddhist Calendar”。 | +| locale | string | 是 | locale用于指定区域，如buddhist在en-US上显示的名称为“Buddhist Calendar”。 | **返回值：** @@ -1017,7 +1017,7 @@ getDisplayName(locale: string): string isWeekend(date?: Date): boolean -判断给定的日期是否在日历中是周末。 +判断指定的日期在日历中是否为周末。 **系统能力**：SystemCapability.Global.I18n @@ -1025,13 +1025,13 @@ isWeekend(date?: Date): boolean | 参数名 | 类型 | 必填 | 说明 | | ---- | ---- | ---- | ---------------------------------------- | -| date | Date | 否 | 判断日期在日历中是否是周末。如果不传日期参数，则判断当前日期是否为周末。 | +| date | Date | 否 | 指定的日期。若不填，则判断当前日期是否为周末。默认值：系统日期。 | **返回值：** | 类型 | 说明 | | ------- | ----------------------------------- | -| boolean | 当所判断的日期为周末时，返回 true，否则返回false。 | +| boolean | 若判断指定日期为周末时，返回true，否则返回false。 | **示例：** ```js @@ -1059,7 +1059,7 @@ constructor(country: string, options?: PhoneNumberFormatOptions) | 参数名 | 类型 | 必填 | 说明 | | ------- | ---------------------------------------- | ---- | ---------------- | | country | string | 是 | 表示电话号码所属国家或地区代码。 | -| options | [PhoneNumberFormatOptions](#phonenumberformatoptions8) | 否 | 电话号码格式化对象的相关选项。 | +| options | [PhoneNumberFormatOptions](#phonenumberformatoptions8) | 否 | 电话号码格式化对象的相关选项。默认值：NATIONAL。 | **示例：** ```js @@ -1184,7 +1184,7 @@ getInstance(locale?:string): IndexUtil | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ---------------------------- | -| locale | string | 否 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | +| locale | string | 否 | 区域设置信息字符串，包括语言以及可选的脚本和区域。默认值：系统Locale。 | **返回值：** @@ -1205,7 +1205,7 @@ getInstance(locale?:string): IndexUtil getIndexList(): Array<string> -获取当前locale对应的索引列表。 +获取当前区域对应的索引列表。 **系统能力**：SystemCapability.Global.I18n @@ -1228,7 +1228,7 @@ getIndexList(): Array<string> addLocale(locale: string): void -将新的locale对应的索引加入当前索引列表。 +在当前索引列表中添加新的区域。 **系统能力**：SystemCapability.Global.I18n @@ -1236,7 +1236,7 @@ addLocale(locale: string): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ---------------------------- | -| locale | string | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | +| locale | string | 是 | 区域设置信息的字符串，包括语言以及可选的脚本和区域。 | **示例：** ```js @@ -1305,7 +1305,7 @@ getLineInstance(locale: string): BreakIterator setLineBreakText(text: string): void -设置[BreakIterator](#breakiterator8)要处理的文本。 +设置BreakIterator要处理的文本。 **系统能力**：SystemCapability.Global.I18n @@ -1326,7 +1326,7 @@ setLineBreakText(text: string): void getLineBreakText(): string -获取[BreakIterator](#breakiterator8)当前处理的文本。 +获取BreakIterator当前处理的文本。 **系统能力**：SystemCapability.Global.I18n @@ -1348,7 +1348,7 @@ getLineBreakText(): string current(): number -获取[BreakIterator](#breakiterator8)对象在当前处理的文本中的位置。 +获取BreakIterator对象在当前处理的文本中的位置。 **系统能力**：SystemCapability.Global.I18n @@ -1370,7 +1370,7 @@ current(): number first(): number -将[BreakIterator](#breakiterator8)对象设置到第一个可断句的分割点。第一个分割点总是被处理的文本的起始位置。 +将BreakIterator对象设置到第一个可断句的分割点。第一个分割点总是被处理的文本的起始位置。 **系统能力**：SystemCapability.Global.I18n @@ -1392,7 +1392,7 @@ first(): number last(): number -将[BreakIterator](#breakiterator8)对象的位置设置到最后一个可断句的分割点。最后一个分割点总是被处理文本末尾的下一个位置。 +将BreakIterator对象的位置设置到最后一个可断句的分割点。最后一个分割点总是被处理文本末尾的下一个位置。 **系统能力**：SystemCapability.Global.I18n @@ -1414,7 +1414,7 @@ last(): number next(index?: number): number -如果index给出，并且index是一个正数将[BreakIterator](#breakiterator8)向后移动number个可断句的分割点，如果n是一个负数，向前移动相应个分割点。若index没有给出，则相当于index = 1。 +将BreakIterator向后移动相应个分割点。 **系统能力**：SystemCapability.Global.I18n @@ -1422,13 +1422,13 @@ next(index?: number): number | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ---------------------------------------- | -| index | number | 否 | [BreakIterator](#breakiterator8)将要移动的分割点数，正数代表向后移动，负数代表向前移动。若index没有给出，则按照index=1处理。 | +| index | number | 否 | BreakIterator将要移动的分割点数。正数代表向后移动，即将BreakIterator向后移动number个可断句的分割点；负数代表向前移动，即向前移动相应个分割点。默认值：1。 | **返回值：** | 类型 | 说明 | | ------ | ---------------------------------------- | -| number | 返回移动了index个分割点后，当前[BreakIterator](#breakiterator8)在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-1。 | +| number | 返回移动了index个分割点后，当前BreakIterator在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-1。 | **示例：** ```js @@ -1444,7 +1444,7 @@ next(index?: number): number previous(): number -将[BreakIterator](#breakiterator8)移动到前一个分割点处。 +将BreakIterator向前移动一个分割点。 **系统能力**：SystemCapability.Global.I18n @@ -1452,7 +1452,7 @@ previous(): number | 类型 | 说明 | | ------ | ---------------------------------------- | -| number | 返回移动到前一个分割点后，当前[BreakIterator](#breakiterator8)在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-1。 | +| number | 返回移动到前一个分割点后，当前BreakIterator在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-1。 | **示例：** ```js @@ -1468,7 +1468,7 @@ previous(): number following(offset: number): number -将[BreakIterator](#breakiterator8)设置到由offset指定的位置的后面一个分割点。返回移动后[BreakIterator](#breakiterator8)的位置。 +将BreakIterator设置到指定位置的后面一个分割点。 **系统能力**：SystemCapability.Global.I18n @@ -1476,13 +1476,13 @@ following(offset: number): number | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ---------------------------------------- | -| offset | number | 是 | 将[BreakIterator](#breakiterator8)对象的位置设置到由offset所指定的位置的下一个分割点。 | +| offset | number | 是 | 将BreakIterator设置到指定位置的后面一个分割点。 | **返回值：** | 类型 | 说明 | | ------ | ---------------------------------------- | -| number | 返回[BreakIterator](#breakiterator8)移动后的位置，如果由offset所指定的位置的下一个分割点超出了文本的范围则返回-1。 | +| number | 返回BreakIterator移动后的位置，如果由offset所指定的位置的下一个分割点超出了文本的范围则返回-1。 | **示例：** ```js @@ -1498,7 +1498,7 @@ following(offset: number): number isBoundary(offset: number): boolean -如果offset所指定的文本位置是一个分割点，那么返回true，否则返回false。如果返回true, 将[BreakIterator](#breakiterator8)对象设置到offset所指定的位置, 否则相当于调用[following](#following8)(offset)。 +判断文本指定位置是否为分割点。 **系统能力**：SystemCapability.Global.I18n @@ -1506,7 +1506,7 @@ isBoundary(offset: number): boolean | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ----------- | -| offset | number | 是 | 指定需要进行判断的位置 | +| offset | number | 是 | 若offset指定的文本位置是一个分割点，则返回true，否则返回false。返回true时，将BreakIterator对象移动到offset指定的位置，否则相当于调用following。 | **返回值：** @@ -1535,7 +1535,7 @@ getTimeZone(zoneID?: string): TimeZone | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ----- | -| zondID | string | 否 | 时区ID。 | +| zondID | string | 否 | 时区ID。默认值：系统时区。 | **返回值：** @@ -1577,7 +1577,7 @@ getID(): string getDisplayName(locale?: string, isDST?: boolean): string -获取时区的本地化表示。 +获取时区对象的本地化表示。 **系统能力**：SystemCapability.Global.I18n @@ -1585,8 +1585,8 @@ getDisplayName(locale?: string, isDST?: boolean): string | 参数名 | 类型 | 必填 | 说明 | | ------ | ------- | ---- | -------------------- | -| locale | string | 否 | 区域ID。 | -| isDST | boolean | 否 | 表示获取时区对象的表示时是否考虑夏令时。 | +| locale | string | 否 | 区域ID。默认值：系统Locale。 | +| isDST | boolean | 否 | 时区对象本地化表示时是否考虑夏令时。默认值：false。 | **返回值：** @@ -1634,7 +1634,7 @@ getOffset(date?: number): number | 类型 | 说明 | | ------ | ----------------------- | -| number | 某一时刻时区对象表示的时区与UTC时区的偏差。 | +| number | 某一时刻时区对象表示的时区与UTC时区的偏差。默认值：系统时间。 | **示例：** ```js @@ -1689,7 +1689,7 @@ static getAvailableZoneCityIDs(): Array<string> static getCityDisplayName(cityID: string, locale: string): string -获取某时区城市在locale下的本地化显示。 +获取某时区城市在该区域的本地化显示。 **系统能力**：SystemCapability.Global.I18n @@ -2097,11 +2097,11 @@ static unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale: | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------- | ---- | ---------------------------------------- | -| fromUnit | [UnitInfo](#unitinfo8) | 是 | 要被转换的单位。 | -| toUnit | [UnitInfo](#unitinfo8) | 是 | 要转换为的单位。 | -| value | number | 是 | 要被转换的单位的数量值。 | +| fromUnit | [UnitInfo](#unitinfo8) | 是 | 需要转换的单位。 | +| toUnit | [UnitInfo](#unitinfo8) | 是 | 转换成的目标单位。 | +| value | number | 是 | 需要转换的单位的数量值。 | | locale | string | 是 | 格式化时使用的区域参数，如：zh-Hans-CN。 | -| style | string | 否 | 格式化使用的风格，取值包括："long", "short", "narrow"。 | +| style | string | 否 | 格式化使用的风格，取值包括："long", "short", "narrow"。默认值：short。 | **返回值：** @@ -2119,7 +2119,7 @@ static unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale: static getDateOrder(locale: string): string -获取某一区域的日期的年、月、日排列顺序。 +获取该区域日期中年、月、日的排列顺序。 **系统能力**：SystemCapability.Global.I18n @@ -2133,7 +2133,7 @@ static getDateOrder(locale: string): string | 类型 | 说明 | | ------ | ------------------- | -| string | 返回某一区域的日期的年、月、日排列顺序 | +| string | 返回该区域年、月、日的排列顺序。 | **示例：** ```js @@ -2290,7 +2290,7 @@ getRegionInfoArray(regions: Array<string>, options?: SortOptions): Array&l | 参数名 | 类型 | 必填 | 说明 | | --------- | ------------- | ---- | ------------- | | regions | Array<string> | 是 | 待排序的国家或地区列表。| -| options | [SortOptions](#sortoptions10) | 否 | 国家或地区排序选项。 | +| options | [SortOptions](#sortoptions10) | 否 | 国家或地区排序选项。默认值：locale的默认值为系统Locale，isUseLocalName的默认值为false，isSuggestedFirst的默认值为true。 | **返回值：** @@ -2353,6 +2353,8 @@ static getTimeZoneCityItemArray(): Array<TimeZoneCityItem> SystemLocaleManager对语言或国家地区列表的排序结果信息项。 +**系统接口**：此接口为系统接口。 + **系统能力**：SystemCapability.Global.I18n | 名称 | 类型 | 必填 | 说明 | @@ -2382,6 +2384,8 @@ SystemLocaleManager对语言或国家地区列表的排序结果信息项。 语言或国家地区的推荐类型。 +**系统接口**：此接口为系统接口。 + **系统能力**：SystemCapability.Global.I18n | 名称 | 值 | 说明 | @@ -2395,13 +2399,15 @@ SystemLocaleManager对语言或国家地区列表的排序结果信息项。 语言或国家地区排序选项。 +**系统接口**：此接口为系统接口。 + **系统能力**：SystemCapability.Global.I18n | 名称 | 类型 | 必填 | 说明 | | --------------- | --------------- | ---- | --------------------------------------- | -| locale | string | 否 | 区域代码，如"zh-Hans-CN"。 | -| isUseLocalName | boolean | 否 | 表示是否使用本地名称进行排序。 | -| isSuggestedFirst | boolean | 否 | 表示是否将推荐语言或国家地区在排序结果中置顶。 | +| locale | string | 否 | 区域代码，如"zh-Hans-CN"。locale属性默认值为系统Locale。 | +| isUseLocalName | boolean | 否 | 表示是否使用本地名称进行排序。若调用方法为getLanguageInfoArray，isUseLocalName属性默认值为true。若调用方法为getRegionInfoArray，isUseLocalName属性默认值为false。 | +| isSuggestedFirst | boolean | 否 | 表示是否将推荐语言或国家地区在排序结果中置顶。isSuggestedFirst属性默认值为true。 | ## I18n.getDisplayCountry(deprecated) @@ -2420,7 +2426,7 @@ getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): stri | ------------ | ------- | ---- | ---------------- | | country | string | 是 | 指定国家。 | | locale | string | 是 | 显示指定国家的区域ID。 | -| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。 | +| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。默认值：true。 | **返回值：** @@ -2451,7 +2457,7 @@ getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): st | ------------ | ------- | ---- | ---------------- | | language | string | 是 | 指定语言。 | | locale | string | 是 | 显示指定语言的区域ID。 | -| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。 | +| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。默认值：true。 | **返回值：** @@ -2602,7 +2608,7 @@ addPreferredLanguage(language: string, index?: number): boolean | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ---------- | | language | string | 是 | 待添加的偏好语言。 | -| index | number | 否 | 偏好语言的添加位置。 | +| index | number | 否 | 偏好语言的添加位置。默认值：系统偏好语言列表长度。 | **返回值：** @@ -2716,7 +2722,7 @@ static unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale: | toUnit | [UnitInfo](#unitinfo8) | 是 | 要转换为的单位。 | | value | number | 是 | 要被转换的单位的数量值。 | | locale | string | 是 | 格式化时使用的区域参数，如：zh-Hans-CN。 | -| style | string | 否 | 格式化使用的风格，取值包括："long", "short", "narrow"。 | +| style | string | 否 | 格式化使用的风格，取值包括："long", "short", "narrow"。默认值：short。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-intl.md b/zh-cn/application-dev/reference/apis/js-apis-intl.md index 5bcda43625069ad5d3e6ee3d258c3f1b222731f4..0f20907149e7dc7102ebaa8aa7dd7b3e579bc4cb 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-intl.md +++ b/zh-cn/application-dev/reference/apis/js-apis-intl.md @@ -14,7 +14,6 @@ ```js import Intl from '@ohos.intl'; ``` -未正确导入包可能产生不明确的接口行为。 ## Locale @@ -25,7 +24,7 @@ import Intl from '@ohos.intl'; | 名称 | 类型 | 可读 | 可写 | 说明 | | --------------- | ------- | ---- | ---- | ---------------------------------------- | -| language | string | 是 | 否 | 与区域设置关联的语， 如：zh。 | +| language | string | 是 | 否 | 与区域设置相关的语言，如：zh。 | | script | string | 是 | 否 | 语言的书写方式，如：Hans。 | | region | string | 是 | 否 | 与区域设置相关的地区，如：CN。 | | baseName | string | 是 | 否 | Locale的基本核心信息（由语言脚本与地区组成），如：zh-Hans-CN。 | @@ -34,7 +33,7 @@ import Intl from '@ohos.intl'; | collation | string | 是 | 否 | 区域的排序规则，取值包括："big5han", "compat", "dict", "direct", "ducet", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed", "searchjl", "stroke", "trad", "unihan", "zhuyin"。 | | hourCycle | string | 是 | 否 | 区域的时制信息，取值包括："h12", "h23", "h11", "h24"。 | | numberingSystem | string | 是 | 否 | 区域使用的数字系统，取值包括："adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "brah", "cakm", "cham", "deva", "diak", "fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho"。 | -| numeric | boolean | 是 | 否 | 是否对数字字符具有特殊的排序规则处理。 | +| numeric | boolean | 是 | 否 | 是否对数字字符具有特殊的排序规则处理。默认值：false。 | ### constructor8+ @@ -66,8 +65,8 @@ constructor(locale: string, options?: LocaleOptions) | 参数名 | 类型 | 必填 | 说明 | | -------------------- | -------------------------------- | ---- | ---------------------------- | -| locale | string | 是 | 包含区域信息的字符串，包括语言以、脚本、国家或地区。语言、脚本、国家或地区的国际标准及组合方式请见[Intl开发指导](../../internationalization/intl-guidelines.md#设置区域信息) | -| options | [LocaleOptions](#localeoptions6) | 否 | 用于创建区域对象的选项。 | +| locale | string | 是 | 区域信息的字符串，由语言、脚本、国家或地区组成。语言、脚本、国家或地区的国际标准及组合方式请见[Intl开发指导](../../internationalization/intl-guidelines.md#设置区域信息) | +| options | [LocaleOptions](#localeoptions6) | 否 | 用于创建区域对象的选项。 | **示例：** ```js @@ -162,7 +161,7 @@ minimize(): Locale ## LocaleOptions6+ 表示区域初始化选项。 -在API9中，LocaleOptions中的属性修改为可选属性。 +从API9开始，LocaleOptions中的属性改为可选。 **系统能力**：SystemCapability.Global.I18n @@ -172,7 +171,7 @@ minimize(): Locale | collation | string | 是 | 是 | 排序参数，取值包括："big5han", "compat", "dict", "direct", "ducet", "emoji", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed ", "search", "searchjl", "standard", "stroke", "trad", "unihan", "zhuyin"。 | | hourCycle | string | 是 | 是 | 时制格式，取值包括："h11", "h12", "h23", "h24"。 | | numberingSystem | string | 是 | 是 | 数字系统，取值包括："adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "brah", "cakm", "cham", "deva", "diak", "fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho"。 | -| numeric | boolean | 是 | 是 | 是否使用12小时制。 | +| numeric | boolean | 是 | 是 | 是否使用12小时制。默认值：false。 | | caseFirst | string | 是 | 是 | 表示大写、小写的排序顺序，取值范围："upper", "lower", "false"。 | @@ -207,7 +206,7 @@ constructor(locale: string | Array<string>, options?: DateTimeOptions) | 参数名 | 类型 | 必填 | 说明 | | -------------------- | ------------------------------------ | ---- | ---------------------------- | | locale | string \| Array<string> | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | -| options | [DateTimeOptions](#datetimeoptions6) | 否 | 用于创建时间日期格式化的选项。 | +| options | [DateTimeOptions](#datetimeoptions6) | 否 | 用于创建时间日期格式化的选项。若所有选项均未设置时，year、month、day三个属性的默认值为numeric。 | **示例：** ```js @@ -314,7 +313,7 @@ resolvedOptions(): DateTimeOptions ## DateTimeOptions6+ 表示时间日期格式化选项。 -在API9中，DateTimeOptions中的属性修改为可选属性。 +从API9开始，DateTimeOptions中的属性改为可选。 **系统能力**：SystemCapability.Global.I18n @@ -326,7 +325,7 @@ resolvedOptions(): DateTimeOptions | hourCycle | string | 是 | 是 | 时制格式，取值包括："h11", "h12", "h23", "h24"。 | | timeZone | string | 是 | 是 | 使用的时区（合法的IANA时区ID）。 | | numberingSystem | string | 是 | 是 | 数字系统，取值包括："adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "brah", "cakm", "cham", "deva", "diak", "fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho"。 | -| hour12 | boolean | 是 | 是 | 是否使用12小时制。 | +| hour12 | boolean | 是 | 是 | 是否使用12小时制。若hour12和hourCycle未设置且系统24小时开关打开时，hour12属性的默认值为false。 | | weekday | string | 是 | 是 | 工作日的显示格式，取值包括："long", "short", "narrow"。 | | era | string | 是 | 是 | 时代的显示格式，取值包括："long", "short", "narrow"。 | | year | string | 是 | 是 | 年份的显示格式，取值包括："numeric", "2-digit"。 | @@ -438,31 +437,31 @@ resolvedOptions(): NumberOptions ## NumberOptions6+ 表示设备支持的能力。 -在API9中，NumberOptions中的属性修改为可选属性。 +从API9开始，NumberOptions中的属性改为可选。 **系统能力**：SystemCapability.Global.I18n | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------------ | ------- | ---- | ---- | ---------------------------------------- | -| locale | string | 是 | 否 | 区域参数， 如："zh-Hans-CN"。 | +| locale | string | 是 | 否 | 区域参数， 如："zh-Hans-CN"。locale属性默认值为系统Locale。 | | currency | string | 是 | 是 | 货币单位， 如："EUR"，"CNY"，"USD"等。 | -| currencySign | string | 是 | 是 | 货币单位的符号显示，取值包括： "symbol"，"narrowSymbol"，"code"，"name" 。 | -| currencyDisplay | string | 是 | 是 | 货币的显示方式，取值包括："symbol", "narrowSymbol", "code", "name"。 | +| currencySign | string | 是 | 是 | 货币单位的符号显示，取值包括： "symbol"，"narrowSymbol"，"code"，"name" 。currencySign属性默认值为standard。 | +| currencyDisplay | string | 是 | 是 | 货币的显示方式，取值包括："symbol", "narrowSymbol", "code", "name"。currencyDisplay属性默认值为symbol。 | | unit | string | 是 | 是 | 单位名称，如："meter"，"inch"，“hectare”等。 | -| unitDisplay | string | 是 | 是 | 单位的显示格式，取值包括："long", "short", "narrow"。 | -| unitUsage8+ | string | 是 | 是 | 单位的使用场景，取值包括："default", "area-land-agricult", "area-land-commercl", "area-land-residntl", "length-person", "length-person-small", "length-rainfall", "length-road", "length-road-small", "length-snowfall", "length-vehicle", "length-visiblty", "length-visiblty-small", "length-person-informal", "length-person-small-informal", "length-road-informal", "speed-road-travel", "speed-wind", "temperature-person", "temperature-weather", "volume-vehicle-fuel"。 | -| signDisplay | string | 是 | 是 | 数字符号的显示格式，取值包括："auto", "never", "always", "expectZero"。 | -| compactDisplay | string | 是 | 是 | 紧凑型的显示格式，取值包括："long", "short"。 | -| notation | string | 是 | 是 | 数字的格式化规格，取值包括："standard", "scientific", "engineering", "compact"。 | -| localeMatcher | string | 是 | 是 | 要使用的区域匹配算法，取值包括："lookup", "best fit"。 | -| style | string | 是 | 是 | 数字的显示格式，取值包括："decimal", "currency", "percent", "unit"。 | -| numberingSystem | string | 是 | 是 | 数字系统，取值包括："adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "brah", "cakm", "cham", "deva", "diak", "fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho"。 | -| useGrouping | boolean | 是 | 是 | 是否分组显示。 | -| minimumIntegerDigits | number | 是 | 是 | 表示要使用的最小整数位数，取值范围：1~21。 | -| minimumFractionDigits | number | 是 | 是 | 表示要使用的最小分数位数，取值范围：0~20。 | -| maximumFractionDigits | number | 是 | 是 | 表示要使用的最大分数位数，取值范围：1~21。 | -| minimumSignificantDigits | number | 是 | 是 | 表示要使用的最低有效位数，取值范围：1~21。 | -| maximumSignificantDigits | number | 是 | 是 | 表示要使用的最大有效位数，取值范围：1~21。 | +| unitDisplay | string | 是 | 是 | 单位的显示格式，取值包括："long", "short", "narrow"。unitDisplay属性默认值为short。 | +| unitUsage8+ | string | 是 | 是 | 单位的使用场景，取值包括："default", "area-land-agricult", "area-land-commercl", "area-land-residntl", "length-person", "length-person-small", "length-rainfall", "length-road", "length-road-small", "length-snowfall", "length-vehicle", "length-visiblty", "length-visiblty-small", "length-person-informal", "length-person-small-informal", "length-road-informal", "speed-road-travel", "speed-wind", "temperature-person", "temperature-weather", "volume-vehicle-fuel"。unitUsage属性默认值为default。 | +| signDisplay | string | 是 | 是 | 数字符号的显示格式，取值包括："auto", "never", "always", "expectZero"。signDisplay属性默认值为auto。 | +| compactDisplay | string | 是 | 是 | 紧凑型的显示格式，取值包括："long", "short"。compactDisplay属性默认值为short。 | +| notation | string | 是 | 是 | 数字的格式化规格，取值包括："standard", "scientific", "engineering", "compact"。notation属性默认值为standard。 | +| localeMatcher | string | 是 | 是 | 要使用的区域匹配算法，取值包括："lookup", "best fit"。localeMatcher属性默认值为best fit。 | +| style | string | 是 | 是 | 数字的显示格式，取值包括："decimal", "currency", "percent", "unit"。style属性默认值为decimal。 | +| numberingSystem | string | 是 | 是 | 数字系统，取值包括："adlm", "ahom", "arab", "arabext", "bali", "beng", "bhks", "brah", "cakm", "cham", "deva", "diak", "fullwide", "gong", "gonm", "gujr", "guru", "hanidec", "hmng", "hmnp", "java", "kali", "khmr", "knda", "lana", "lanatham", "laoo", "latn", "lepc", "limb", "mathbold", "mathdbl", "mathmono", "mathsanb", "mathsans", "mlym", "modi", "mong", "mroo", "mtei", "mymr", "mymrshan", "mymrtlng", "newa", "nkoo", "olck", "orya", "osma", "rohg", "saur", "segment", "shrd", "sind", "sinh", "sora", "sund", "takr", "talu", "tamldec", "telu", "thai", "tibt", "tirh", "vaii", "wara", "wcho"。numberingSystem属性默认值为locale的默认数字系统。 | +| useGrouping | boolean | 是 | 是 | 是否分组显示。useGrouping属性默认值为auto。 | +| minimumIntegerDigits | number | 是 | 是 | 表示要使用的最小整数位数，取值范围：1~21。minimumIntegerDigits属性默认值为1。 | +| minimumFractionDigits | number | 是 | 是 | 表示要使用的最小分数位数，取值范围：0~20。minimumFractionDigits属性默认值为0。 | +| maximumFractionDigits | number | 是 | 是 | 表示要使用的最大分数位数，取值范围：1~21。maximumFractionDigits属性默认值为3。 | +| minimumSignificantDigits | number | 是 | 是 | 表示要使用的最低有效位数，取值范围：1~21。minimumSignificantDigits属性默认值为1。 | +| maximumSignificantDigits | number | 是 | 是 | 表示要使用的最大有效位数，取值范围：1~21。maximumSignificantDigits属性默认值为21。 | ## Collator8+ @@ -496,7 +495,7 @@ constructor(locale: string | Array<string>, options?: CollatorOptions) | 参数名 | 类型 | 必填 | 说明 | | -------------------- | ------------------------------------ | ---- | ---------------------------- | | locale | string \| Array<string> | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | -| options | [CollatorOptions](#collatoroptions8) | 否 | 用于创建排序对象的选项。 | +| options | [CollatorOptions](#collatoroptions8) | 否 | 用于创建排序对象的选项。 | **示例：** ```js @@ -562,19 +561,19 @@ resolvedOptions(): CollatorOptions ## CollatorOptions8+ 表示Collator可设置的属性。 -在API9中，CollatorOptions中的属性修改为可选属性。 +从API9中，CollatorOptions中的属性改为可选。 **系统能力**：SystemCapability.Global.I18n | 名称 | 类型 | 可读 | 可写 | 说明 | | ----------------- | ------- | ---- | ---- | ---------------------------------------- | -| localeMatcher | string | 是 | 是 | locale匹配算法，取值范围："best fit", "lookup"。 | -| usage | string | 是 | 是 | 比较的用途，取值范围："sort", "search"。 | -| sensitivity | string | 是 | 是 | 表示字符串中的哪些差异会导致非零结果值，取值范围："base", "accent", "case", "letiant"。 | -| ignorePunctuation | boolean | 是 | 是 | 表示是否忽略标点符号，取值范围：true, false。 | -| collation | string | 是 | 是 | 排序规则，取值范围："big5han", "compat", "dict", "direct", "ducet", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed", "searchjl", "stroke", "trad", "unihan", "zhuyin"。 | -| numeric | boolean | 是 | 是 | 是否使用数字排序，取值范围：true, false。 | -| caseFirst | string | 是 | 是 | 表示大写、小写的排序顺序，取值范围："upper", "lower", "false"。 | +| localeMatcher | string | 是 | 是 | locale匹配算法，取值范围："best fit", "lookup"。localeMatcher属性默认值为best fit。 | +| usage | string | 是 | 是 | 比较的用途，取值范围："sort", "search"。usage属性默认值为sort。 | +| sensitivity | string | 是 | 是 | 表示字符串中的哪些差异会导致非零结果值，取值范围："base", "accent", "case", "letiant"。sensitivity属性默认值为variant。 | +| ignorePunctuation | boolean | 是 | 是 | 表示是否忽略标点符号，取值范围：true, false。ignorePunctuation属性默认值为false。 | +| collation | string | 是 | 是 | 排序规则，取值范围："big5han", "compat", "dict", "direct", "ducet", "eor", "gb2312", "phonebk", "phonetic", "pinyin", "reformed", "searchjl", "stroke", "trad", "unihan", "zhuyin"。collation属性默认值为default。 | +| numeric | boolean | 是 | 是 | 是否使用数字排序，取值范围：true, false。numeric属性默认值为false。 | +| caseFirst | string | 是 | 是 | 表示大写、小写的排序顺序，取值范围："upper", "lower", "false"。caseFirst属性默认值为false | ## PluralRules8+ @@ -608,7 +607,7 @@ constructor(locale: string | Array<string>, options?: PluralRulesOptions) | 参数名 | 类型 | 必填 | 说明 | | -------------------- | ---------------------------------------- | ---- | ---------------------------- | | locale | string \| Array<string> | 是 | 包含区域设置信息的字符串，包括语言以及可选的脚本和区域。 | -| options | [PluralRulesOptions](#pluralrulesoptions8) | 否 | 用于创建单复数对象的选项。 | +| options | [PluralRulesOptions](#pluralrulesoptions8) | 否 | 用于创建单复数对象的选项。 | **示例：** ```js @@ -654,19 +653,19 @@ select(n: number): string ## PluralRulesOptions8+ 表示PluralRules对象可设置的属性。 -在API9中，PluralRulesOptions中的属性修改为可选属性。 +从API9开始，PluralRulesOptions中的属性改为可选。 **系统能力**：SystemCapability.Global.I18n | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------------------ | ------ | ---- | ---- | ---------------------------------------- | -| localeMatcher | string | 是 | 是 | locale匹配算法，取值包括："best fit", "lookup"。 | -| type | string | 是 | 是 | 排序的类型，取值包括："cardinal", "ordinal"。 | -| minimumIntegerDigits | number | 是 | 是 | 表示要使用的最小整数位数，取值范围：1~21。 | -| minimumFractionDigits | number | 是 | 是 | 表示要使用的最小分数位数，取值范围：0~20。 | -| maximumFractionDigits | number | 是 | 是 | 表示要使用的最大分数位数，取值范围：1~21。 | -| minimumSignificantDigits | number | 是 | 是 | 表示要使用的最低有效位数，取值范围：1~21。 | -| maximumSignificantDigits | number | 是 | 是 | 表示要使用的最大有效位数，取值范围：1~21。 | +| localeMatcher | string | 是 | 是 | locale匹配算法，取值包括："best fit", "lookup"。localeMatcher属性默认值为best fit。 | +| type | string | 是 | 是 | 排序的类型，取值包括："cardinal", "ordinal"。type属性默认值为cardinal。 | +| minimumIntegerDigits | number | 是 | 是 | 表示要使用的最小整数位数，取值范围：1~21。minimumIntegerDigits属性默认值为1。 | +| minimumFractionDigits | number | 是 | 是 | 表示要使用的最小分数位数，取值范围：0~20。minimumFractionDigits属性默认值为0。 | +| maximumFractionDigits | number | 是 | 是 | 表示要使用的最大分数位数，取值范围：1~21。maximumFractionDigits属性默认值为3。 | +| minimumSignificantDigits | number | 是 | 是 | 表示要使用的最低有效位数，取值范围：1~21。minimumSignificantDigits属性默认值为1。 | +| maximumSignificantDigits | number | 是 | 是 | 表示要使用的最大有效位数，取值范围：1~21。maximumSignificantDigits属性默认值为21。 | ## RelativeTimeFormat8+ @@ -795,15 +794,14 @@ resolvedOptions(): RelativeTimeFormatResolvedOptions ## RelativeTimeFormatInputOptions8+ 表示RelativeTimeFormat对象可设置的属性。 -在API9中，RelativeTimeFormatInputOptions中的属性修改为可选属性。 +从API9开始，RelativeTimeFormatInputOptions中的属性改为可选。 **系统能力**：SystemCapability.Global.I18n - | 名称 | 类型 | 可读 | 可写 | 说明 | | ------------- | ------ | ---- | ---- | ---------------------------------------- | -| localeMatcher | string | 是 | 是 | locale匹配算法，取值包括："best fit", "lookup"。 | -| numeric | string | 是 | 是 | 输出消息的格式，取值包括："always", "auto"。 | -| style | string | 是 | 是 | 国际化消息的长度，取值包括："long", "short", "narrow"。 | +| localeMatcher | string | 是 | 是 | locale匹配算法，取值包括："best fit", "lookup"。localeMatcher属性默认值为best fit。 | +| numeric | string | 是 | 是 | 输出消息的格式，取值包括："always", "auto"。numeric属性默认值为always。 | +| style | string | 是 | 是 | 国际化消息的长度，取值包括："long", "short", "narrow"。style属性默认值为long。 | ## RelativeTimeFormatResolvedOptions8+