提交 5b14bd7f 编写于 作者: S sunyaozu

Optional parameters provide default values

Signed-off-by: Nsunyaozu <sunyaozu@huawei.com>
上级 a7fb2ef5
......@@ -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&lt;string&gt;
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,&nbsp;chinese,&nbsp;coptic,&nbsp;ethiopic,&nbsp;hebrew,&nbsp;gregory,&nbsp;indian,&nbsp;islamic_civil,&nbsp;islamic_tbla,&nbsp;islamic_umalqura,&nbsp;japanese,&nbsp;persian。当type没有给出时,采用区域默认的日历类型。 |
| type | string | 否 | 合法的日历类型,目前合法的类型有buddhist,&nbsp;chinese,&nbsp;coptic,&nbsp;ethiopic,&nbsp;hebrew,&nbsp;gregory,&nbsp;indian,&nbsp;islamic_civil,&nbsp;islamic_tbla,&nbsp;islamic_umalqura,&nbsp;japanese,&nbsp;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&nbsp;Calendar”。 |
| locale | string | 是 | locale用于指定区域,如buddhist在en-US上显示的名称为“Buddhist&nbsp;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 | 当所判断的日期为周末时,返回&nbsp;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&lt;string&gt;
获取当前locale对应的索引列表。
获取当前区域对应的索引列表。
**系统能力**:SystemCapability.Global.I18n
......@@ -1228,7 +1228,7 @@ getIndexList(): Array&lt;string&gt;
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&lt;string&gt;
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",&nbsp;"short",&nbsp;"narrow"。 |
| style | string | 否 | 格式化使用的风格,取值包括:"long",&nbsp;"short",&nbsp;"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&lt;string&gt;, options?: SortOptions): Array&l
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------- | ---- | ------------- |
| regions | Array&lt;string&gt; | 是 | 待排序的国家或地区列表。|
| options | [SortOptions](#sortoptions10) | 否 | 国家或地区排序选项。 |
| options | [SortOptions](#sortoptions10) | 否 | 国家或地区排序选项。默认值:locale的默认值为系统Locale,isUseLocalName的默认值为false,isSuggestedFirst的默认值为true。 |
**返回值:**
......@@ -2325,6 +2325,8 @@ getRegionInfoArray(regions: Array&lt;string&gt;, options?: SortOptions): Array&l
SystemLocaleManager对语言或国家地区列表的排序结果信息项。
**系统接口**:此接口为系统接口。
**系统能力**:SystemCapability.Global.I18n
| 名称 | 类型 | 必填 | 说明 |
......@@ -2339,6 +2341,8 @@ SystemLocaleManager对语言或国家地区列表的排序结果信息项。
语言或国家地区的推荐类型。
**系统接口**:此接口为系统接口。
**系统能力**:SystemCapability.Global.I18n
| 名称 | 值 | 说明 |
......@@ -2352,13 +2356,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<sup>(deprecated)</sup>
......@@ -2377,7 +2383,7 @@ getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): stri
| ------------ | ------- | ---- | ---------------- |
| country | string | 是 | 指定国家。 |
| locale | string | 是 | 显示指定国家的区域ID。 |
| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。 |
| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。默认值:true。 |
**返回值:**
......@@ -2408,7 +2414,7 @@ getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): st
| ------------ | ------- | ---- | ---------------- |
| language | string | 是 | 指定语言。 |
| locale | string | 是 | 显示指定语言的区域ID。 |
| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。 |
| sentenceCase | boolean | 否 | 本地化显示文本是否要首字母大写。默认值:true。 |
**返回值:**
......@@ -2559,7 +2565,7 @@ addPreferredLanguage(language: string, index?: number): boolean
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---------- |
| language | string | 是 | 待添加的偏好语言。 |
| index | number | 否 | 偏好语言的添加位置。 |
| index | number | 否 | 偏好语言的添加位置。默认值:系统偏好语言列表长度。 |
**返回值:**
......@@ -2673,7 +2679,7 @@ static unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale:
| toUnit | [UnitInfo](#unitinfo8) | 是 | 要转换为的单位。 |
| value | number | 是 | 要被转换的单位的数量值。 |
| locale | string | 是 | 格式化时使用的区域参数,如:zh-Hans-CN。 |
| style | string | 否 | 格式化使用的风格,取值包括:"long",&nbsp;"short",&nbsp;"narrow"。 |
| style | string | 否 | 格式化使用的风格,取值包括:"long",&nbsp;"short",&nbsp;"narrow"。默认值:short。 |
**返回值:**
......
......@@ -14,7 +14,6 @@
```js
import Intl from '@ohos.intl';
```
未正确导入包可能产生不明确的接口行为。
## Locale
......@@ -25,7 +24,7 @@ import Intl from '@ohos.intl';
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ------- | ---- | ---- | ---------------------------------------- |
| language | string | 是 | 否 | 与区域设置关联的语,&nbsp;如: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",&nbsp;"compat",&nbsp;"dict",&nbsp;"direct",&nbsp;"ducet",&nbsp;"eor",&nbsp;"gb2312",&nbsp;"phonebk",&nbsp;"phonetic",&nbsp;"pinyin",&nbsp;"reformed",&nbsp;"searchjl",&nbsp;"stroke",&nbsp;"trad",&nbsp;"unihan",&nbsp;"zhuyin"。 |
| hourCycle | string | 是 | 否 | 区域的时制信息,取值包括:"h12",&nbsp;"h23",&nbsp;"h11",&nbsp;"h24"。 |
| numberingSystem | string | 是 | 否 | 区域使用的数字系统,取值包括:"adlm",&nbsp;"ahom",&nbsp;"arab",&nbsp;"arabext",&nbsp;"bali",&nbsp;"beng",&nbsp;"bhks",&nbsp;"brah",&nbsp;"cakm",&nbsp;"cham",&nbsp;"deva",&nbsp;"diak",&nbsp;"fullwide",&nbsp;"gong",&nbsp;"gonm",&nbsp;"gujr",&nbsp;"guru",&nbsp;"hanidec",&nbsp;"hmng",&nbsp;"hmnp",&nbsp;"java",&nbsp;"kali",&nbsp;"khmr",&nbsp;"knda",&nbsp;"lana",&nbsp;"lanatham",&nbsp;"laoo",&nbsp;"latn",&nbsp;"lepc",&nbsp;"limb",&nbsp;"mathbold",&nbsp;"mathdbl",&nbsp;"mathmono",&nbsp;"mathsanb",&nbsp;"mathsans",&nbsp;"mlym",&nbsp;"modi",&nbsp;"mong",&nbsp;"mroo",&nbsp;"mtei",&nbsp;"mymr",&nbsp;"mymrshan",&nbsp;"mymrtlng",&nbsp;"newa",&nbsp;"nkoo",&nbsp;"olck",&nbsp;"orya",&nbsp;"osma",&nbsp;"rohg",&nbsp;"saur",&nbsp;"segment",&nbsp;"shrd",&nbsp;"sind",&nbsp;"sinh",&nbsp;"sora",&nbsp;"sund",&nbsp;"takr",&nbsp;"talu",&nbsp;"tamldec",&nbsp;"telu",&nbsp;"thai",&nbsp;"tibt",&nbsp;"tirh",&nbsp;"vaii",&nbsp;"wara",&nbsp;"wcho"。 |
| numeric | boolean | 是 | 否 | 是否对数字字符具有特殊的排序规则处理。 |
| numeric | boolean | 是 | 否 | 是否对数字字符具有特殊的排序规则处理。默认值:false。 |
### constructor<sup>8+</sup>
......@@ -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
## LocaleOptions<sup>6+</sup>
表示区域初始化选项。
在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",&nbsp;"h12",&nbsp;"h23",&nbsp;"h24"。 |
| numberingSystem | string | 是 | 是 | 数字系统,取值包括:"adlm",&nbsp;"ahom",&nbsp;"arab",&nbsp;"arabext",&nbsp;"bali",&nbsp;"beng",&nbsp;"bhks",&nbsp;"brah",&nbsp;"cakm",&nbsp;"cham",&nbsp;"deva",&nbsp;"diak",&nbsp;"fullwide",&nbsp;"gong",&nbsp;"gonm",&nbsp;"gujr",&nbsp;"guru",&nbsp;"hanidec",&nbsp;"hmng",&nbsp;"hmnp",&nbsp;"java",&nbsp;"kali",&nbsp;"khmr",&nbsp;"knda",&nbsp;"lana",&nbsp;"lanatham",&nbsp;"laoo",&nbsp;"latn",&nbsp;"lepc",&nbsp;"limb",&nbsp;"mathbold",&nbsp;"mathdbl",&nbsp;"mathmono",&nbsp;"mathsanb",&nbsp;"mathsans",&nbsp;"mlym",&nbsp;"modi",&nbsp;"mong",&nbsp;"mroo",&nbsp;"mtei",&nbsp;"mymr",&nbsp;"mymrshan",&nbsp;"mymrtlng",&nbsp;"newa",&nbsp;"nkoo",&nbsp;"olck",&nbsp;"orya",&nbsp;"osma",&nbsp;"rohg",&nbsp;"saur",&nbsp;"segment",&nbsp;"shrd",&nbsp;"sind",&nbsp;"sinh",&nbsp;"sora",&nbsp;"sund",&nbsp;"takr",&nbsp;"talu",&nbsp;"tamldec",&nbsp;"telu",&nbsp;"thai",&nbsp;"tibt",&nbsp;"tirh",&nbsp;"vaii",&nbsp;"wara",&nbsp;"wcho"。 |
| numeric | boolean | 是 | 是 | 是否使用12小时制。 |
| numeric | boolean | 是 | 是 | 是否使用12小时制。默认值:false。 |
| caseFirst | string | 是 | 是 | 表示大写、小写的排序顺序,取值范围:"upper",&nbsp;"lower",&nbsp;"false"。 |
......@@ -207,7 +206,7 @@ constructor(locale: string | Array&lt;string&gt;, options?: DateTimeOptions)
| 参数名 | 类型 | 必填 | 说明 |
| -------------------- | ------------------------------------ | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| options | [DateTimeOptions](#datetimeoptions6) | 否 | 用于创建时间日期格式化的选项。 |
| options | [DateTimeOptions](#datetimeoptions6) | 否 | 用于创建时间日期格式化的选项。若所有选项均未设置时,year、month、day三个属性的默认值为numeric。 |
**示例:**
```js
......@@ -314,7 +313,7 @@ resolvedOptions(): DateTimeOptions
## DateTimeOptions<sup>6+</sup>
表示时间日期格式化选项。
在API9中,DateTimeOptions中的属性修改为可选属性
从API9开始,DateTimeOptions中的属性改为可选
**系统能力**:SystemCapability.Global.I18n
......@@ -326,7 +325,7 @@ resolvedOptions(): DateTimeOptions
| hourCycle | string | 是 | 是 | 时制格式,取值包括:"h11",&nbsp;"h12",&nbsp;"h23",&nbsp;"h24"。 |
| timeZone | string | 是 | 是 | 使用的时区(合法的IANA时区ID)。 |
| numberingSystem | string | 是 | 是 | 数字系统,取值包括:"adlm",&nbsp;"ahom",&nbsp;"arab",&nbsp;"arabext",&nbsp;"bali",&nbsp;"beng",&nbsp;"bhks",&nbsp;"brah",&nbsp;"cakm",&nbsp;"cham",&nbsp;"deva",&nbsp;"diak",&nbsp;"fullwide",&nbsp;"gong",&nbsp;"gonm",&nbsp;"gujr",&nbsp;"guru",&nbsp;"hanidec",&nbsp;"hmng",&nbsp;"hmnp",&nbsp;"java",&nbsp;"kali",&nbsp;"khmr",&nbsp;"knda",&nbsp;"lana",&nbsp;"lanatham",&nbsp;"laoo",&nbsp;"latn",&nbsp;"lepc",&nbsp;"limb",&nbsp;"mathbold",&nbsp;"mathdbl",&nbsp;"mathmono",&nbsp;"mathsanb",&nbsp;"mathsans",&nbsp;"mlym",&nbsp;"modi",&nbsp;"mong",&nbsp;"mroo",&nbsp;"mtei",&nbsp;"mymr",&nbsp;"mymrshan",&nbsp;"mymrtlng",&nbsp;"newa",&nbsp;"nkoo",&nbsp;"olck",&nbsp;"orya",&nbsp;"osma",&nbsp;"rohg",&nbsp;"saur",&nbsp;"segment",&nbsp;"shrd",&nbsp;"sind",&nbsp;"sinh",&nbsp;"sora",&nbsp;"sund",&nbsp;"takr",&nbsp;"talu",&nbsp;"tamldec",&nbsp;"telu",&nbsp;"thai",&nbsp;"tibt",&nbsp;"tirh",&nbsp;"vaii",&nbsp;"wara",&nbsp;"wcho"。 |
| hour12 | boolean | 是 | 是 | 是否使用12小时制。 |
| hour12 | boolean | 是 | 是 | 是否使用12小时制。若hour12和hourCycle未设置且系统24小时开关打开时,hour12属性的默认值为false。 |
| weekday | string | 是 | 是 | 工作日的显示格式,取值包括:"long",&nbsp;"short",&nbsp;"narrow"。 |
| era | string | 是 | 是 | 时代的显示格式,取值包括:"long",&nbsp;"short",&nbsp;"narrow"。 |
| year | string | 是 | 是 | 年份的显示格式,取值包括:"numeric",&nbsp;"2-digit"。 |
......@@ -438,31 +437,31 @@ resolvedOptions(): NumberOptions
## NumberOptions<sup>6+</sup>
表示设备支持的能力。
在API9中,NumberOptions中的属性修改为可选属性
从API9开始,NumberOptions中的属性改为可选
**系统能力**:SystemCapability.Global.I18n
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------ | ------- | ---- | ---- | ---------------------------------------- |
| locale | string | 是 | 否 | 区域参数,&nbsp;如:"zh-Hans-CN"。 |
| locale | string | 是 | 否 | 区域参数,&nbsp;如:"zh-Hans-CN"。locale属性默认值为系统Locale。 |
| currency | string | 是 | 是 | 货币单位,&nbsp;如:"EUR","CNY","USD"等。 |
| currencySign | string | 是 | 是 | 货币单位的符号显示,取值包括:&nbsp;"symbol","narrowSymbol","code","name"&nbsp;。 |
| currencyDisplay | string | 是 | 是 | 货币的显示方式,取值包括:"symbol",&nbsp;"narrowSymbol",&nbsp;"code",&nbsp;"name"。 |
| currencySign | string | 是 | 是 | 货币单位的符号显示,取值包括:&nbsp;"symbol","narrowSymbol","code","name"&nbsp;currencySign属性默认值为standard。 |
| currencyDisplay | string | 是 | 是 | 货币的显示方式,取值包括:"symbol",&nbsp;"narrowSymbol",&nbsp;"code",&nbsp;"name"。currencyDisplay属性默认值为symbol。 |
| unit | string | 是 | 是 | 单位名称,如:"meter","inch",“hectare”等。 |
| unitDisplay | string | 是 | 是 | 单位的显示格式,取值包括:"long",&nbsp;"short",&nbsp;"narrow"。 |
| unitUsage<sup>8+</sup> | string | 是 | 是 | 单位的使用场景,取值包括:"default",&nbsp;"area-land-agricult",&nbsp;"area-land-commercl",&nbsp;"area-land-residntl",&nbsp;"length-person",&nbsp;"length-person-small",&nbsp;"length-rainfall",&nbsp;"length-road",&nbsp;"length-road-small",&nbsp;"length-snowfall",&nbsp;"length-vehicle",&nbsp;"length-visiblty",&nbsp;"length-visiblty-small",&nbsp;"length-person-informal",&nbsp;"length-person-small-informal",&nbsp;"length-road-informal",&nbsp;"speed-road-travel",&nbsp;"speed-wind",&nbsp;"temperature-person",&nbsp;"temperature-weather",&nbsp;"volume-vehicle-fuel"。 |
| signDisplay | string | 是 | 是 | 数字符号的显示格式,取值包括:"auto",&nbsp;"never",&nbsp;"always",&nbsp;"expectZero"。 |
| compactDisplay | string | 是 | 是 | 紧凑型的显示格式,取值包括:"long",&nbsp;"short"。 |
| notation | string | 是 | 是 | 数字的格式化规格,取值包括:"standard",&nbsp;"scientific",&nbsp;"engineering",&nbsp;"compact"。 |
| localeMatcher | string | 是 | 是 | 要使用的区域匹配算法,取值包括:"lookup",&nbsp;"best&nbsp;fit"。 |
| style | string | 是 | 是 | 数字的显示格式,取值包括:"decimal",&nbsp;"currency",&nbsp;"percent",&nbsp;"unit"。 |
| numberingSystem | string | 是 | 是 | 数字系统,取值包括:"adlm",&nbsp;"ahom",&nbsp;"arab",&nbsp;"arabext",&nbsp;"bali",&nbsp;"beng",&nbsp;"bhks",&nbsp;"brah",&nbsp;"cakm",&nbsp;"cham",&nbsp;"deva",&nbsp;"diak",&nbsp;"fullwide",&nbsp;"gong",&nbsp;"gonm",&nbsp;"gujr",&nbsp;"guru",&nbsp;"hanidec",&nbsp;"hmng",&nbsp;"hmnp",&nbsp;"java",&nbsp;"kali",&nbsp;"khmr",&nbsp;"knda",&nbsp;"lana",&nbsp;"lanatham",&nbsp;"laoo",&nbsp;"latn",&nbsp;"lepc",&nbsp;"limb",&nbsp;"mathbold",&nbsp;"mathdbl",&nbsp;"mathmono",&nbsp;"mathsanb",&nbsp;"mathsans",&nbsp;"mlym",&nbsp;"modi",&nbsp;"mong",&nbsp;"mroo",&nbsp;"mtei",&nbsp;"mymr",&nbsp;"mymrshan",&nbsp;"mymrtlng",&nbsp;"newa",&nbsp;"nkoo",&nbsp;"olck",&nbsp;"orya",&nbsp;"osma",&nbsp;"rohg",&nbsp;"saur",&nbsp;"segment",&nbsp;"shrd",&nbsp;"sind",&nbsp;"sinh",&nbsp;"sora",&nbsp;"sund",&nbsp;"takr",&nbsp;"talu",&nbsp;"tamldec",&nbsp;"telu",&nbsp;"thai",&nbsp;"tibt",&nbsp;"tirh",&nbsp;"vaii",&nbsp;"wara",&nbsp;"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",&nbsp;"short",&nbsp;"narrow"。unitDisplay属性默认值为short。 |
| unitUsage<sup>8+</sup> | string | 是 | 是 | 单位的使用场景,取值包括:"default",&nbsp;"area-land-agricult",&nbsp;"area-land-commercl",&nbsp;"area-land-residntl",&nbsp;"length-person",&nbsp;"length-person-small",&nbsp;"length-rainfall",&nbsp;"length-road",&nbsp;"length-road-small",&nbsp;"length-snowfall",&nbsp;"length-vehicle",&nbsp;"length-visiblty",&nbsp;"length-visiblty-small",&nbsp;"length-person-informal",&nbsp;"length-person-small-informal",&nbsp;"length-road-informal",&nbsp;"speed-road-travel",&nbsp;"speed-wind",&nbsp;"temperature-person",&nbsp;"temperature-weather",&nbsp;"volume-vehicle-fuel"。unitUsage属性默认值为default。 |
| signDisplay | string | 是 | 是 | 数字符号的显示格式,取值包括:"auto",&nbsp;"never",&nbsp;"always",&nbsp;"expectZero"。signDisplay属性默认值为auto。 |
| compactDisplay | string | 是 | 是 | 紧凑型的显示格式,取值包括:"long",&nbsp;"short"。compactDisplay属性默认值为short。 |
| notation | string | 是 | 是 | 数字的格式化规格,取值包括:"standard",&nbsp;"scientific",&nbsp;"engineering",&nbsp;"compact"。notation属性默认值为standard。 |
| localeMatcher | string | 是 | 是 | 要使用的区域匹配算法,取值包括:"lookup",&nbsp;"best&nbsp;fit"。localeMatcher属性默认值为best fit。 |
| style | string | 是 | 是 | 数字的显示格式,取值包括:"decimal",&nbsp;"currency",&nbsp;"percent",&nbsp;"unit"。style属性默认值为decimal。 |
| numberingSystem | string | 是 | 是 | 数字系统,取值包括:"adlm",&nbsp;"ahom",&nbsp;"arab",&nbsp;"arabext",&nbsp;"bali",&nbsp;"beng",&nbsp;"bhks",&nbsp;"brah",&nbsp;"cakm",&nbsp;"cham",&nbsp;"deva",&nbsp;"diak",&nbsp;"fullwide",&nbsp;"gong",&nbsp;"gonm",&nbsp;"gujr",&nbsp;"guru",&nbsp;"hanidec",&nbsp;"hmng",&nbsp;"hmnp",&nbsp;"java",&nbsp;"kali",&nbsp;"khmr",&nbsp;"knda",&nbsp;"lana",&nbsp;"lanatham",&nbsp;"laoo",&nbsp;"latn",&nbsp;"lepc",&nbsp;"limb",&nbsp;"mathbold",&nbsp;"mathdbl",&nbsp;"mathmono",&nbsp;"mathsanb",&nbsp;"mathsans",&nbsp;"mlym",&nbsp;"modi",&nbsp;"mong",&nbsp;"mroo",&nbsp;"mtei",&nbsp;"mymr",&nbsp;"mymrshan",&nbsp;"mymrtlng",&nbsp;"newa",&nbsp;"nkoo",&nbsp;"olck",&nbsp;"orya",&nbsp;"osma",&nbsp;"rohg",&nbsp;"saur",&nbsp;"segment",&nbsp;"shrd",&nbsp;"sind",&nbsp;"sinh",&nbsp;"sora",&nbsp;"sund",&nbsp;"takr",&nbsp;"talu",&nbsp;"tamldec",&nbsp;"telu",&nbsp;"thai",&nbsp;"tibt",&nbsp;"tirh",&nbsp;"vaii",&nbsp;"wara",&nbsp;"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。 |
## Collator<sup>8+</sup>
......@@ -496,7 +495,7 @@ constructor(locale: string | Array&lt;string&gt;, options?: CollatorOptions)
| 参数名 | 类型 | 必填 | 说明 |
| -------------------- | ------------------------------------ | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| options | [CollatorOptions](#collatoroptions8) | 否 | 用于创建排序对象的选项。 |
| options | [CollatorOptions](#collatoroptions8) | 否 | 用于创建排序对象的选项。 |
**示例:**
```js
......@@ -562,19 +561,19 @@ resolvedOptions(): CollatorOptions
## CollatorOptions<sup>8+</sup>
表示Collator可设置的属性。
在API9中,CollatorOptions中的属性修改为可选属性
从API9中,CollatorOptions中的属性改为可选
**系统能力**:SystemCapability.Global.I18n
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------- | ------- | ---- | ---- | ---------------------------------------- |
| localeMatcher | string | 是 | 是 | locale匹配算法,取值范围:"best&nbsp;fit",&nbsp;"lookup"。 |
| usage | string | 是 | 是 | 比较的用途,取值范围:"sort",&nbsp;"search"。 |
| sensitivity | string | 是 | 是 | 表示字符串中的哪些差异会导致非零结果值,取值范围:"base",&nbsp;"accent",&nbsp;"case",&nbsp;"letiant"。 |
| ignorePunctuation | boolean | 是 | 是 | 表示是否忽略标点符号,取值范围:true,&nbsp;false。 |
| collation | string | 是 | 是 | 排序规则,取值范围:"big5han",&nbsp;"compat",&nbsp;"dict",&nbsp;"direct",&nbsp;"ducet",&nbsp;"eor",&nbsp;"gb2312",&nbsp;"phonebk",&nbsp;"phonetic",&nbsp;"pinyin",&nbsp;"reformed",&nbsp;"searchjl",&nbsp;"stroke",&nbsp;"trad",&nbsp;"unihan",&nbsp;"zhuyin"。 |
| numeric | boolean | 是 | 是 | 是否使用数字排序,取值范围:true,&nbsp;false。 |
| caseFirst | string | 是 | 是 | 表示大写、小写的排序顺序,取值范围:"upper",&nbsp;"lower",&nbsp;"false"。 |
| localeMatcher | string | 是 | 是 | locale匹配算法,取值范围:"best&nbsp;fit",&nbsp;"lookup"。localeMatcher属性默认值为best fit。 |
| usage | string | 是 | 是 | 比较的用途,取值范围:"sort",&nbsp;"search"。usage属性默认值为sort。 |
| sensitivity | string | 是 | 是 | 表示字符串中的哪些差异会导致非零结果值,取值范围:"base",&nbsp;"accent",&nbsp;"case",&nbsp;"letiant"。sensitivity属性默认值为variant。 |
| ignorePunctuation | boolean | 是 | 是 | 表示是否忽略标点符号,取值范围:true,&nbsp;false。ignorePunctuation属性默认值为false。 |
| collation | string | 是 | 是 | 排序规则,取值范围:"big5han",&nbsp;"compat",&nbsp;"dict",&nbsp;"direct",&nbsp;"ducet",&nbsp;"eor",&nbsp;"gb2312",&nbsp;"phonebk",&nbsp;"phonetic",&nbsp;"pinyin",&nbsp;"reformed",&nbsp;"searchjl",&nbsp;"stroke",&nbsp;"trad",&nbsp;"unihan",&nbsp;"zhuyin"。collation属性默认值为default。 |
| numeric | boolean | 是 | 是 | 是否使用数字排序,取值范围:true,&nbsp;false。numeric属性默认值为false。 |
| caseFirst | string | 是 | 是 | 表示大写、小写的排序顺序,取值范围:"upper",&nbsp;"lower",&nbsp;"false"。caseFirst属性默认值为false |
## PluralRules<sup>8+</sup>
......@@ -608,7 +607,7 @@ constructor(locale: string | Array&lt;string&gt;, options?: PluralRulesOptions)
| 参数名 | 类型 | 必填 | 说明 |
| -------------------- | ---------------------------------------- | ---- | ---------------------------- |
| locale | string \| Array&lt;string&gt; | 是 | 包含区域设置信息的字符串,包括语言以及可选的脚本和区域。 |
| options | [PluralRulesOptions](#pluralrulesoptions8) | 否 | 用于创建单复数对象的选项。 |
| options | [PluralRulesOptions](#pluralrulesoptions8) | 否 | 用于创建单复数对象的选项。 |
**示例:**
```js
......@@ -654,19 +653,19 @@ select(n: number): string
## PluralRulesOptions<sup>8+</sup>
表示PluralRules对象可设置的属性。
在API9中,PluralRulesOptions中的属性修改为可选属性
从API9开始,PluralRulesOptions中的属性改为可选
**系统能力**:SystemCapability.Global.I18n
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------ | ------ | ---- | ---- | ---------------------------------------- |
| localeMatcher | string | 是 | 是 | locale匹配算法,取值包括:"best&nbsp;fit",&nbsp;"lookup"。 |
| type | string | 是 | 是 | 排序的类型,取值包括:"cardinal",&nbsp;"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&nbsp;fit",&nbsp;"lookup"。localeMatcher属性默认值为best fit。 |
| type | string | 是 | 是 | 排序的类型,取值包括:"cardinal",&nbsp;"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。 |
## RelativeTimeFormat<sup>8+</sup>
......@@ -795,15 +794,14 @@ resolvedOptions(): RelativeTimeFormatResolvedOptions
## RelativeTimeFormatInputOptions<sup>8+</sup>
表示RelativeTimeFormat对象可设置的属性。
在API9中,RelativeTimeFormatInputOptions中的属性修改为可选属性
从API9开始,RelativeTimeFormatInputOptions中的属性改为可选
**系统能力**:SystemCapability.Global.I18n
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------- | ------ | ---- | ---- | ---------------------------------------- |
| localeMatcher | string | 是 | 是 | locale匹配算法,取值包括:"best&nbsp;fit",&nbsp;"lookup"。 |
| numeric | string | 是 | 是 | 输出消息的格式,取值包括:"always",&nbsp;"auto"。 |
| style | string | 是 | 是 | 国际化消息的长度,取值包括:"long",&nbsp;"short",&nbsp;"narrow"。 |
| localeMatcher | string | 是 | 是 | locale匹配算法,取值包括:"best&nbsp;fit",&nbsp;"lookup"。localeMatcher属性默认值为best fit。 |
| numeric | string | 是 | 是 | 输出消息的格式,取值包括:"always",&nbsp;"auto"。numeric属性默认值为always。 |
| style | string | 是 | 是 | 国际化消息的长度,取值包括:"long",&nbsp;"short",&nbsp;"narrow"。style属性默认值为long。 |
## RelativeTimeFormatResolvedOptions<sup>8+</sup>
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册