!5699 【文档体验官】intl-guidelines.md 格式错乱

Merge pull request !5699 from king_he/0622-d

!5699 【文档体验官】intl-guidelines.md 格式错乱
Merge pull request !5699 from king_he/0622-d
284b7c93 · openharmony_ci · Gitee · 95c06be0 · b893337d · 284b7c93
隐藏空白更改
内联并排

Showing with 104 addition and 85 deletion

zh-cn/application-dev/internationalization/intl-guidelines.md ...n/application-dev/internationalization/intl-guidelines.md +104 -85

未找到文件。
--- a/zh-cn/application-dev/internationalization/intl-guidelines.md
+++ b/zh-cn/application-dev/internationalization/intl-guidelines.md
@@ -2,7 +2,6 @@

 Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方法。

-
 ## 设置区域信息

 调用[Locale](../reference/apis/js-apis-intl.md)的相关接口实现最大化区域信息或最小化区域信息。
@@ -10,44 +9,48 @@ Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方

 ### 接口说明

-| 模块        | 接口名称                                     | 描述                         |
-| --------- | ---------------------------------------- | -------------------------- |
-| ohos.intl | constructor()<sup>8+</sup>               | 实例化Locale对象。               |
-| ohos.intl | constructor(locale:&nbsp;string,&nbsp;options?:&nbsp;LocaleOptions) | 基于locale参数及其选项实例化Locale对象。 |
-| ohos.intl | toString():&nbsp;string                  | 将Locale信息转换为字符串。           |
-| ohos.intl | maximize():&nbsp;Locale                  | 最大化区域信息。                   |
-| ohos.intl | minimize():&nbsp;Locale                  | 最小化区域信息。                   |
+| 模块 | 接口名称 | 描述 |
+| -------- | -------- | -------- |
+| ohos.intl | constructor()<sup>8+</sup> | 实例化Locale对象。 |
+| ohos.intl | constructor(locale:string,options?:LocaleOptions) | 基于locale参数及其选项实例化Locale对象。 |
+| ohos.intl | toString():string | 将Locale信息转换为字符串。 |
+| ohos.intl | maximize():Locale | 最大化区域信息。 |
+| ohos.intl | minimize():Locale | 最小化区域信息。 |


 ### 开发步骤

-1. 实例化Locale对象
-   使用Locale的构造函数创建Locale对象，该方法接收一个表示Locale的字符串及可选的[属性](../reference/apis/js-apis-intl.md)列表（intl为导入的模块名）。
+1. 实例化Locale对象。

+   使用Locale的构造函数创建Locale对象，该方法接收一个表示Locale的字符串及可选的[属性](../reference/apis/js-apis-intl.md)列表（intl为导入的模块名）。

+   
   ```
   var locale = "zh-CN";
   var options = {caseFirst: false, calendar: "chinese", collation: pinyin};
   var localeObj = new intl.Locale(locale, options);
   ```

-2. 获取Locale的字符串表示
-     调用toString方法来获取Locale对象的字符串表示，其中包括了语言、区域及其他选项信息。
+2. 获取Locale的字符串表示。

+     调用toString方法来获取Locale对象的字符串表示，其中包括了语言、区域及其他选项信息。
+     
   ```
   var localeStr = localeObj.toString();
   ```

-3. 最大化区域信息
-     调用maximize方法来最大化区域信息，即当缺少脚本与地区信息时，对其进行补全。
+3. 最大化区域信息。

+     调用maximize方法来最大化区域信息，即当缺少脚本与地区信息时，对其进行补全。
+     
   ```
   var maximizedLocale = localeObj.maximize();
   ```

-4. 最小化区域信息
-     调用minimize方法来最小化区域信息，即当存在脚本与地区信息时，对其进行删除。
+4. 最小化区域信息。

+     调用minimize方法来最小化区域信息，即当存在脚本与地区信息时，对其进行删除。
+     
   ```
   var minimizedLocale = localeObj.minimize();
   ```
@@ -60,52 +63,56 @@ Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方

 ### 接口说明

-| 模块        | 接口名称                                     | 描述                                       |
-| --------- | ---------------------------------------- | ---------------------------------------- |
-| ohos.intl | constructor()<sup>8+</sup>               | 创建日期时间格式化对象。                             |
-| ohos.intl | constructor(locale:&nbsp;string&nbsp;\|&nbsp;Array&lt;string&gt;,&nbsp;options?:&nbsp;DateTimeOptions) | 创建日期时间格式化对象，并设置提供的Locale和格式化相关属性。        |
-| ohos.intl | format(date:&nbsp;Date):&nbsp;string     | 依据DateTimeFormat对象的Locale及其他格式化属性，计算日期时间的格式化表示。 |
-| ohos.intl | formatRange(startDate:&nbsp;Date,&nbsp;endDate:&nbsp;Date):&nbsp;string | 依据DateTimeFormat对象的Locale及其他格式化属性，计算时间段的格式化表示。 |
-| ohos.intl | resolvedOptions():&nbsp;DateTimeOptions  | 获取DateTimeFormat对象的相关属性。                 |
+| 模块 | 接口名称 | 描述 |
+| -------- | -------- | -------- |
+| ohos.intl | constructor()<sup>8+</sup> | 创建日期时间格式化对象。 |
+| ohos.intl | constructor(locale:string\|Array&lt;string&gt;,options?:DateTimeOptions) | 创建日期时间格式化对象，并设置提供的Locale和格式化相关属性。 |
+| ohos.intl | format(date:Date):string | 依据DateTimeFormat对象的Locale及其他格式化属性，计算日期时间的格式化表示。 |
+| ohos.intl | formatRange(startDate:Date,endDate:Date):string | 依据DateTimeFormat对象的Locale及其他格式化属性，计算时间段的格式化表示。 |
+| ohos.intl | resolvedOptions():DateTimeOptions | 获取DateTimeFormat对象的相关属性。 |


 ### 开发步骤

-1. 实例化日期时间格式化对象
-   一种方法是使用DateTimeFormat提供的默认构造函数，通过访问系统语言和地区设置，获取系统默认Locale，并将其作为DateTimeFormat对象内部的Locale（intl为导入的模块名）。
+1. 实例化日期时间格式化对象。

+   一种方法是使用DateTimeFormat提供的默认构造函数，通过访问系统语言和地区设置，获取系统默认Locale，并将其作为DateTimeFormat对象内部的Locale（intl为导入的模块名）。

+   
   ```
   var dateTimeFormat = new intl.DateTimeFormat();
   ```

     另一种方法是使用开发者提供的Locale和格式化参数来创建日期时间格式化对象。其中，格式化参数是可选的，完整的格式化参数列表见[DateTimeOptions](../reference/apis/js-apis-intl.md)。
-
+   
   ```
   var options = {dateStyle: "full", timeStyle: "full"};
   var dateTimeFormat = new intl.DateTimeFormat("zh-CN", options);
   ```

-2. 格式化日期时间
-     使用DateTimeFormat的format方法对一个Date对象进行格式化，该方法会返回一个字符串作为格式化的结果。
+2. 格式化日期时间。

+     使用DateTimeFormat的format方法对一个Date对象进行格式化，该方法会返回一个字符串作为格式化的结果。
+     
   ```
   Date date = new Date();
   var formatResult = dateTimeFormat.format(date);
   ```

-3. 格式化时间段
-     使用DateTimeFormat的formatRange方法对一个时间段进行格式化。该方法需要传入两个Date对象，分别表示时间段的起止时间，返回一个字符串作为格式化的结果。
+3. 格式化时间段。

+     使用DateTimeFormat的formatRange方法对一个时间段进行格式化。该方法需要传入两个Date对象，分别表示时间段的起止时间，返回一个字符串作为格式化的结果。
+     
   ```
   Date startDate = new Date();
   Date endDate = new Date();
   var formatResult = dateTimeFormat.formatRange(startDate, endDate);
   ```

-4. 访问日期时间格式化对象的相关属性
-     DateTimeFormat的resolvedOptions方法会返回一个对象，该对象包含了DateTimeFormat对象的所有相关属性及其值。
+4. 访问日期时间格式化对象的相关属性。

+     DateTimeFormat的resolvedOptions方法会返回一个对象，该对象包含了DateTimeFormat对象的所有相关属性及其值。
+     
   ```
   var options = dateTimeFormat.resolvedOptions();
   ```
@@ -118,42 +125,45 @@ Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方

 ### 接口说明

-| 模块        | 接口名称                                     | 描述                                       |
-| --------- | ---------------------------------------- | ---------------------------------------- |
-| ohos.intl | constructor()<SUP>8+</SUP>               | 创建数字格式化对象。                               |
-| ohos.intl | constructor(locale:&nbsp;string&nbsp;\|&nbsp;Array&lt;string&gt;,&nbsp;options?:&nbsp;NumberOptions) | 创建数字格式化对象，并设置提供的locale和格式化相关属性。          |
-| ohos.intl | format(number:&nbsp;number):&nbsp;string | 依据NumberFormat对象的Locale及其他格式化属性，计算数字的格式化表示。 |
-| ohos.intl | resolvedOptions():&nbsp;NumberOptions    | 获取NumberFormat对象的相关属性。                   |
+| 模块 | 接口名称 | 描述 |
+| -------- | -------- | -------- |
+| ohos.intl | constructor()<SUP>8+</SUP> | 创建数字格式化对象。 |
+| ohos.intl | constructor(locale:string\|Array&lt;string&gt;,options?:NumberOptions) | 创建数字格式化对象，并设置提供的locale和格式化相关属性。 |
+| ohos.intl | format(number:number):string | 依据NumberFormat对象的Locale及其他格式化属性，计算数字的格式化表示。 |
+| ohos.intl | resolvedOptions():NumberOptions | 获取NumberFormat对象的相关属性。 |


 ### 开发步骤

-1. 实例化数字格式化对象
-   一种方法是使用NumberFormat提供的默认构造函数，通过访问系统的语言和地区以获取系统默认Locale并进行设置（intl为导入的模块名）。
+1. 实例化数字格式化对象。

+   一种方法是使用NumberFormat提供的默认构造函数，通过访问系统的语言和地区以获取系统默认Locale并进行设置（intl为导入的模块名）。

+   
   ```
   var numberFormat = new intl.NumberFormat();
   ```

     另一种方法是使用开发者提供的Locale和格式化参数来创建数字格式化对象。其中，格式化参数是可选的，完整的格式化参数列表参见[NumberOptions](../reference/apis/js-apis-intl.md)。
-
+   
   ```
   var options = {compactDisplay: "short", notation: "compact"};
   var numberFormat = new intl.NumberFormat("zh-CN", options);
   ```

-2. 数字格式化
-     使用NumberFormat的format方法对传入的数字进行格式化。该方法返回一个字符串作为格式化的结果。
+2. 数字格式化。

+     使用NumberFormat的format方法对传入的数字进行格式化。该方法返回一个字符串作为格式化的结果。
+     
   ```
   var number = 1234.5678
   var formatResult = numberFormat.format(number);
   ```

-3. 访问数字格式化对象的相关属性
-     NumberFormat的resolvedOptions方法会返回一个对象，该对象包含了NumberFormat对象的所有相关属性及其值。
+3. 访问数字格式化对象的相关属性。

+     NumberFormat的resolvedOptions方法会返回一个对象，该对象包含了NumberFormat对象的所有相关属性及其值。
+     
   ```
   var options = numberFormat.resolvedOptions();
   ```
@@ -166,42 +176,45 @@ Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方

 ### 接口说明

-| 模块        | 接口名称                                     | 描述                              |
-| --------- | ---------------------------------------- | ------------------------------- |
-| ohos.intl | constructor()<sup>8+</sup>               | 创建排序对象。                         |
-| ohos.intl | constructor(locale:&nbsp;string&nbsp;\|&nbsp;Array&lt;string&gt;,&nbsp;options?:&nbsp;CollatorOptions)<sup>8+</sup> | 创建排序对象，并设置提供的locale和其他相关属性。     |
-| ohos.intl | compare(first:&nbsp;string,&nbsp;second:&nbsp;string):&nbsp;number<sup>8+</sup> | 依据排序对象的Locale及其属性，计算两个字符串的比较结果。 |
-| ohos.intl | resolvedOptions():&nbsp;CollatorOptions<sup>8+</sup> | 获取排序对象的相关属性。                    |
+| 模块 | 接口名称 | 描述 |
+| -------- | -------- | -------- |
+| ohos.intl | constructor()<sup>8+</sup> | 创建排序对象。 |
+| ohos.intl | constructor(locale:string\|Array&lt;string&gt;,options?:CollatorOptions)<sup>8+</sup> | 创建排序对象，并设置提供的locale和其他相关属性。 |
+| ohos.intl | compare(first:string,second:string):number<sup>8+</sup> | 依据排序对象的Locale及其属性，计算两个字符串的比较结果。 |
+| ohos.intl | resolvedOptions():CollatorOptions<sup>8+</sup> | 获取排序对象的相关属性。 |


 ### 开发步骤

-1. 实例化排序对象
-   一种方法是使用Collator提供的默认构造函数，通过访问系统的语言和地区以获取系统默认Locale并进行设置（intl为导入的模块名）。
+1. 实例化排序对象。

+   一种方法是使用Collator提供的默认构造函数，通过访问系统的语言和地区以获取系统默认Locale并进行设置（intl为导入的模块名）。

+   
   ```
   var collator = new intl.Collator();
   ```

     另一种方法是使用开发者提供的Locale和其他相关参数来创建Collator对象，完整的参数列表参见[CollatorOptions](../reference/apis/js-apis-intl.md)。
-
+   
   ```
   var collator= new intl.Collator("zh-CN", {localeMatcher: "best fit", usage: "sort"};
   ```

-2. 比较字符串
-     使用Collator的compare方法对传入的两个字符串进行比较。该方法返回一个数值作为比较的结果，返回-1表示第一个字符串小于第二个字符串，返回1表示第一个字符大于第二个字符串，返回0表示两个字符串相同。
+2. 比较字符串。

+     使用Collator的compare方法对传入的两个字符串进行比较。该方法返回一个数值作为比较的结果，返回-1表示第一个字符串小于第二个字符串，返回1表示第一个字符大于第二个字符串，返回0表示两个字符串相同。
+     
   ```
   var str1 = "first string";
   var str2 = "second string";
   var compareResult = collator.compare(str1, str2);
   ```

-3. 访问排序对象的相关属性
-     Collator的resolvedOptions方法会返回一个对象，该对象包含了Collator对象的所有相关属性及其值。
+3. 访问排序对象的相关属性。

+     Collator的resolvedOptions方法会返回一个对象，该对象包含了Collator对象的所有相关属性及其值。
+     
   ```
   var options = collator.resolvedOptions();
   ```
@@ -214,32 +227,34 @@ Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方

 ### 接口说明

-| 模块        | 接口名称                                     | 描述                                 |
-| --------- | ---------------------------------------- | ---------------------------------- |
-| ohos.intl | constructor()<sup>8+</sup>               | 创建单复数对象。                           |
-| ohos.intl | constructor(locale:&nbsp;string&nbsp;\|&nbsp;Array&lt;string&gt;,&nbsp;options?:&nbsp;PluralRulesOptions)<sup>8+</sup> | 创建单复数对象，并设置提供的locale和其他相关属性。       |
-| ohos.intl | select(n:&nbsp;number):&nbsp;string<sup>8+</sup> | 依据单复数对象的Locale及其他格式化属性，计算数字的单复数类别。 |
+| 模块 | 接口名称 | 描述 |
+| -------- | -------- | -------- |
+| ohos.intl | constructor()<sup>8+</sup> | 创建单复数对象。 |
+| ohos.intl | constructor(locale:string\|Array&lt;string&gt;,options?:PluralRulesOptions)<sup>8+</sup> | 创建单复数对象，并设置提供的locale和其他相关属性。 |
+| ohos.intl | select(n:number):string<sup>8+</sup> | 依据单复数对象的Locale及其他格式化属性，计算数字的单复数类别。 |


 ### 开发步骤

-1. 实例化单复数对象
-   一种方法是使用PluralRules提供的默认构造函数，通过访问系统的语言和地区以获取系统默认Locale并进行设置（intl为导入的模块名）。
+1. 实例化单复数对象。

+   一种方法是使用PluralRules提供的默认构造函数，通过访问系统的语言和地区以获取系统默认Locale并进行设置（intl为导入的模块名）。

+   
   ```
   var pluralRules = new intl.PluralRules();
   ```

-     另一种方法是使用开发者提供的Locale和其他相关参数来创建单复数对象，完整的参数列表参见[PluralRulesOptions](../reference/apis/js-apis-intl.md)。
-
+     另一种方法是使用开发者提供的Locale和其他相关参数来创建单复数对象。完整的参数列表参见[PluralRulesOptions](../reference/apis/js-apis-intl.md)。
+   
   ```
   var plurals = new intl.PluralRules("zh-CN", {localeMatcher: "best fit", type: "cardinal"};
   ```

-2. 计算数字单复数类别
-     使用PluralRules的select方法计算传入数字的单复数类别。该方法返回一个字符串作为传入数字的类别，包括："zero", "one", "two", "few", "many", "other"六个类别。
+2. 计算数字单复数类别。

+     使用PluralRules的select方法计算传入数字的单复数类别。该方法返回一个字符串作为传入数字的类别，包括："zero", "one", "two", "few", "many", "other"六个类别。
+     
   ```
   var number = 1234.5678
   var categoryResult = plurals.select(number);
@@ -253,52 +268,56 @@ Intl开发指导提供了ECMA 402中定义的国际化能力接口的使用方

 ### 接口说明

-| 模块        | 接口名称                                     | 描述                                       |
-| --------- | ---------------------------------------- | ---------------------------------------- |
-| ohos.intl | constructor()<sup>8+</sup>               | 创建相对时间格式化对象。                             |
-| ohos.intl | constructor(locale:&nbsp;string&nbsp;\|&nbsp;Array&lt;string&gt;,&nbsp;options?:&nbsp;RelativeTimeFormatInputOptions)<sup>8+</sup> | 创建相对时间格式化对象，并设置提供的locale和格式化相关属性。        |
-| ohos.intl | format(value:&nbsp;number,&nbsp;unit:&nbsp;string):&nbsp;string<sup>8+</sup> | 依据相对时间格式化对象的Locale及其他格式化属性，计算相对时间的格式化表示。 |
-| ohos.intl | formatToParts(value:&nbsp;number,&nbsp;unit:&nbsp;string):&nbsp;Array&lt;object&gt;<sup>8+</sup> | 依据相对时间格式化对象的Locale及其他格式化属性，返回相对时间格式化表示的各个部分。 |
-| ohos.intl | resolvedOptions():&nbsp;RelativeTimeFormatResolvedOptions<sup>8+</sup> | 获取相对时间格式化对象的相关属性。                        |
+| 模块 | 接口名称 | 描述 |
+| -------- | -------- | -------- |
+| ohos.intl | constructor()<sup>8+</sup> | 创建相对时间格式化对象。 |
+| ohos.intl | constructor(locale:string\|Array&lt;string&gt;,options?:RelativeTimeFormatInputOptions)<sup>8+</sup> | 创建相对时间格式化对象，并设置提供的locale和格式化相关属性。 |
+| ohos.intl | format(value:number,unit:string):string<sup>8+</sup> | 依据相对时间格式化对象的Locale及其他格式化属性，计算相对时间的格式化表示。 |
+| ohos.intl | formatToParts(value:number,unit:string):Array&lt;object&gt;<sup>8+</sup> | 依据相对时间格式化对象的Locale及其他格式化属性，返回相对时间格式化表示的各个部分。 |
+| ohos.intl | resolvedOptions():RelativeTimeFormatResolvedOptions<sup>8+</sup> | 获取相对时间格式化对象的相关属性。 |


 ### 开发步骤

-1. 实例化相对时间格式化对象
-   一种方法是使用RelativeTimeFormat提供的默认构造函数，通过访问系统的语言和地区以获取系统默认Locale并进行设置（intl为导入的模块名）。
+1. 实例化相对时间格式化对象。

+   一种方法是使用RelativeTimeFormat提供的默认构造函数，通过访问系统的语言和地区以获取系统默认Locale并进行设置（intl为导入的模块名）。

+   
   ```
   var relativeTimeFormat = new intl.RelativeTimeFormat();
   ```

     另一种方法是使用开发者提供的Locale和格式化参数来创建相对时间格式化对象。其中，格式化参数是可选的，完整的参数列表参见[ RelativeTimeFormatInputOptions](../reference/apis/js-apis-intl.md)。
-
+   
   ```
   var relativeTimeFormat = new intl.RelativeTimeFormat("zh-CN", {numeric: "always", style: "long"};
   ```

-2. 相对时间格式化
-     使用RelativeTimeFormat的format方法对相对时间进行格式化。方法接收一个表示相对时间长度的数值和表示单位的字符串，其中单位包括："year", "quarter", "month", "week", "day", "hour", "minute", "second"。方法返回一个字符串作为格式化的结果。
+2. 相对时间格式化。

+     使用RelativeTimeFormat的format方法对相对时间进行格式化。方法接收一个表示相对时间长度的数值和表示单位的字符串，其中单位包括："year", "quarter", "month", "week", "day", "hour", "minute", "second"。方法返回一个字符串作为格式化的结果。
+     
   ```
   var number = 2;
   var unit = "year"
   var formatResult = relativeTimeFormat.format(number, unit);
   ```

-3. 获取相对时间格式化结果的各个部分
-     获取相对时间格式化结果的各个部分，从而自定义格式化结果。
+3. 获取相对时间格式化结果的各个部分。

+     获取相对时间格式化结果的各个部分，从而自定义格式化结果。
+     
   ```
   var number = 2;
   var unit = "year"
   var formatResult = relativeTimeFormat.formatToParts(number, unit);
   ```

-4. 访问相对时间格式化对象的相关属性
-     RelativeTimeFormat的resolvedOptions方法会返回一个对象，该对象包含了RelativeTimeFormat对象的所有相关属性及其值，完整的属性列表参见[ RelativeTimeFormatResolvedOptions](../reference/apis/js-apis-intl.md)。
+4. 访问相对时间格式化对象的相关属性。

+     RelativeTimeFormat的resolvedOptions方法会返回一个对象，该对象包含了RelativeTimeFormat对象的所有相关属性及其值，完整的属性列表参见[ RelativeTimeFormatResolvedOptions](../reference/apis/js-apis-intl.md)。
+     
   ```
   var options = numberFormat.resolvedOptions();
   ```