Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“5c9f38b8e6eaa1dfe9de4a4f8bd6c9b13dc0d23d”上不存在“...net/ssl/git@gitcode.net:openanolis/dragonwell8_jdk.git”
未验证 提交 61b7ef48 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!23003 i18n中ArkTs语法整改 

Merge pull request !23003 from W.J/master
上级 3c7a4da1 c8d69f1e
显示空白变更内容
内联 并排
Showing with 180 addition and 109 deletion
zh-cn/application-dev/reference/apis/js-apis-i18n.md
浏览文件 @ 61b7ef48
...@@ -11,7 +11,7 @@ ...@@ -11,7 +11,7 @@
## 导入模块 ## 导入模块
```js ```ts
import I18n from '@ohos.i18n'; import I18n from '@ohos.i18n';
``` ```
...@@ -49,11 +49,14 @@ static getDisplayCountry(country: string, locale: string, sentenceCase?: boolean ...@@ -49,11 +49,14 @@ static getDisplayCountry(country: string, locale: string, sentenceCase?: boolean
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let displayCountry: string = I18n.System.getDisplayCountry("zh-CN", "en-GB"); // displayCountry = "China" let displayCountry: string = I18n.System.getDisplayCountry("zh-CN", "en-GB"); // displayCountry = "China"
} catch (error) { } catch (error) {
console.error(`call System.getDisplayCountry failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -88,11 +91,14 @@ static getDisplayLanguage(language: string, locale: string, sentenceCase?: boole ...@@ -88,11 +91,14 @@ static getDisplayLanguage(language: string, locale: string, sentenceCase?: boole
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let displayLanguage: string = I18n.System.getDisplayLanguage("zh", "en-GB"); // displayLanguage = Chinese let displayLanguage: string = I18n.System.getDisplayLanguage("zh", "en-GB"); // displayLanguage = Chinese
} catch(error) { } catch(error) {
console.error(`call System.getDisplayLanguage failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -119,11 +125,14 @@ static getSystemLanguages(): Array<string> ...@@ -119,11 +125,14 @@ static getSystemLanguages(): Array<string>
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let systemLanguages: Array<string> = I18n.System.getSystemLanguages(); // [ "en-Latn-US", "zh-Hans" ] let systemLanguages: Array<string> = I18n.System.getSystemLanguages(); // [ "en-Latn-US", "zh-Hans" ]
} catch(error) { } catch(error) {
console.error(`call System.getSystemLanguages failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -156,11 +165,14 @@ static getSystemCountries(language: string): Array&lt;string&gt; ...@@ -156,11 +165,14 @@ static getSystemCountries(language: string): Array&lt;string&gt;
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let systemCountries: Array<string> = I18n.System.getSystemCountries('zh'); // systemCountries = [ "ZW", "YT", "YE", ..., "ER", "CN", "DE" ]，共计240个国家或地区 let systemCountries: Array<string> = I18n.System.getSystemCountries('zh'); // systemCountries = [ "ZW", "YT", "YE", ..., "ER", "CN", "DE" ]，共计240个国家或地区
} catch(error) { } catch(error) {
console.error(`call System.getSystemCountries failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -194,11 +206,14 @@ static isSuggested(language: string, region?: string): boolean ...@@ -194,11 +206,14 @@ static isSuggested(language: string, region?: string): boolean
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let res: boolean = I18n.System.isSuggested('zh', 'CN'); // res = true let res: boolean = I18n.System.isSuggested('zh', 'CN'); // res = true
} catch(error) { } catch(error) {
console.error(`call System.isSuggested failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -225,11 +240,14 @@ static getSystemLanguage(): string ...@@ -225,11 +240,14 @@ static getSystemLanguage(): string
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let systemLanguage: string = I18n.System.getSystemLanguage(); // systemLanguage为当前系统语言 let systemLanguage: string = I18n.System.getSystemLanguage(); // systemLanguage为当前系统语言
} catch(error) { } catch(error) {
console.error(`call System.getSystemLanguage failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -260,11 +278,14 @@ static setSystemLanguage(language: string): void ...@@ -260,11 +278,14 @@ static setSystemLanguage(language: string): void
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
I18n.System.setSystemLanguage('zh'); // 设置系统当前语言为 "zh" I18n.System.setSystemLanguage('zh'); // 设置系统当前语言为 "zh"
} catch(error) { } catch(error) {
console.error(`call System.setSystemLanguage failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -291,11 +312,14 @@ static getSystemRegion(): string ...@@ -291,11 +312,14 @@ static getSystemRegion(): string
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let systemRegion: string = I18n.System.getSystemRegion(); // 获取系统当前地区设置 let systemRegion: string = I18n.System.getSystemRegion(); // 获取系统当前地区设置
} catch(error) { } catch(error) {
console.error(`call System.getSystemRegion failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -326,11 +350,14 @@ static setSystemRegion(region: string): void ...@@ -326,11 +350,14 @@ static setSystemRegion(region: string): void
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
I18n.System.setSystemRegion('CN'); // 设置系统当前地区为 "CN" I18n.System.setSystemRegion('CN'); // 设置系统当前地区为 "CN"
} catch(error) { } catch(error) {
console.error(`call System.setSystemRegion failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -357,11 +384,14 @@ static getSystemLocale(): string ...@@ -357,11 +384,14 @@ static getSystemLocale(): string
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let systemLocale: string = I18n.System.getSystemLocale(); // 获取系统当前Locale let systemLocale: string = I18n.System.getSystemLocale(); // 获取系统当前Locale
} catch(error) { } catch(error) {
console.error(`call System.getSystemLocale failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -392,11 +422,14 @@ static setSystemLocale(locale: string): void ...@@ -392,11 +422,14 @@ static setSystemLocale(locale: string): void
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
I18n.System.setSystemLocale('zh-CN'); // 设置系统当前Locale为 "zh-CN" I18n.System.setSystemLocale('zh-CN'); // 设置系统当前Locale为 "zh-CN"
} catch(error) { } catch(error) {
console.error(`call System.setSystemLocale failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -423,11 +456,14 @@ static is24HourClock(): boolean ...@@ -423,11 +456,14 @@ static is24HourClock(): boolean
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let is24HourClock: boolean = I18n.System.is24HourClock(); // 系统24小时开关是否开启 let is24HourClock: boolean = I18n.System.is24HourClock(); // 系统24小时开关是否开启
} catch(error) { } catch(error) {
console.error(`call System.is24HourClock failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -458,12 +494,15 @@ static set24HourClock(option: boolean): void ...@@ -458,12 +494,15 @@ static set24HourClock(option: boolean): void
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
// 将系统时间设置为24小时制 // 将系统时间设置为24小时制
try { try {
I18n.System.set24HourClock(true); I18n.System.set24HourClock(true);
} catch(error) { } catch(error) {
console.error(`call System.set24HourClock failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -495,14 +534,17 @@ static addPreferredLanguage(language: string, index?: number): void ...@@ -495,14 +534,17 @@ static addPreferredLanguage(language: string, index?: number): void
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
// 将语言zh-CN添加到系统偏好语言列表中 // 将语言zh-CN添加到系统偏好语言列表中
let language = 'zh-CN'; let language = 'zh-CN';
let index = 0; let index = 0;
try { try {
I18n.System.addPreferredLanguage(language, index); // 将zh-CN添加到系统偏好语言列表的第1位 I18n.System.addPreferredLanguage(language, index); // 将zh-CN添加到系统偏好语言列表的第1位
} catch(error) { } catch(error) {
console.error(`call System.addPreferredLanguage failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -533,13 +575,16 @@ static removePreferredLanguage(index: number): void ...@@ -533,13 +575,16 @@ static removePreferredLanguage(index: number): void
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
// 删除系统偏好语言列表中的第一个偏好语言 // 删除系统偏好语言列表中的第一个偏好语言
let index: number = 0; let index: number = 0;
try { try {
I18n.System.removePreferredLanguage(index); I18n.System.removePreferredLanguage(index);
} catch(error) { } catch(error) {
console.error(`call System.removePreferredLanguage failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -566,11 +611,14 @@ static getPreferredLanguageList(): Array&lt;string&gt; ...@@ -566,11 +611,14 @@ static getPreferredLanguageList(): Array&lt;string&gt;
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let preferredLanguageList: Array<string> = I18n.System.getPreferredLanguageList(); // 获取系统当前偏好语言列表 let preferredLanguageList: Array<string> = I18n.System.getPreferredLanguageList(); // 获取系统当前偏好语言列表
} catch(error) { } catch(error) {
console.error(`call System.getPreferredLanguageList failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -597,11 +645,14 @@ static getFirstPreferredLanguage(): string ...@@ -597,11 +645,14 @@ static getFirstPreferredLanguage(): string
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let firstPreferredLanguage: string = I18n.System.getFirstPreferredLanguage(); // 获取系统当前偏好语言列表中的第一个偏好语言 let firstPreferredLanguage: string = I18n.System.getFirstPreferredLanguage(); // 获取系统当前偏好语言列表中的第一个偏好语言
} catch(error) { } catch(error) {
console.error(`call System.getFirstPreferredLanguage failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -628,11 +679,14 @@ static getAppPreferredLanguage(): string ...@@ -628,11 +679,14 @@ static getAppPreferredLanguage(): string
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let appPreferredLanguage: string = I18n.System.getAppPreferredLanguage(); // 获取应用偏好语言 let appPreferredLanguage: string = I18n.System.getAppPreferredLanguage(); // 获取应用偏好语言
} catch(error) { } catch(error) {
console.error(`call System.getAppPreferredLanguage failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -664,10 +718,13 @@ static setUsingLocalDigit(flag: boolean): void ...@@ -664,10 +718,13 @@ static setUsingLocalDigit(flag: boolean): void
**示例：** **示例：**
```ts ```ts
import { BusinessError } from '@ohos.base';
try { try {
I18n.System.setUsingLocalDigit(true); // 打开本地化数字开关 I18n.System.setUsingLocalDigit(true); // 打开本地化数字开关
} catch(error) { } catch(error) {
console.error(`call System.setUsingLocalDigit failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -695,10 +752,13 @@ static getUsingLocalDigit(): boolean ...@@ -695,10 +752,13 @@ static getUsingLocalDigit(): boolean
**示例：** **示例：**
```ts ```ts
import { BusinessError } from '@ohos.base';
try { try {
let status: boolean = I18n.System.getUsingLocalDigit(); // 判断本地化数字开关是否打开 let status: boolean = I18n.System.getUsingLocalDigit(); // 判断本地化数字开关是否打开
} catch(error) { } catch(error) {
console.error(`call System.getUsingLocalDigit failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -724,7 +784,7 @@ isRTL(locale: string): boolean ...@@ -724,7 +784,7 @@ isRTL(locale: string): boolean
| boolean | true表示该locale从右至左显示语言；false表示该locale从左至右显示语言。 | | boolean | true表示该locale从右至左显示语言；false表示该locale从左至右显示语言。 |
**示例：** **示例：**
```js ```ts
I18n.isRTL("zh-CN");// 中文不是RTL语言，返回false I18n.isRTL("zh-CN");// 中文不是RTL语言，返回false
I18n.isRTL("ar-EG");// 阿语是RTL语言，返回true I18n.isRTL("ar-EG");// 阿语是RTL语言，返回true
``` ```
...@@ -752,7 +812,7 @@ getCalendar(locale: string, type? : string): Calendar ...@@ -752,7 +812,7 @@ getCalendar(locale: string, type? : string): Calendar
| [Calendar](#calendar8) | 日历对象。 | | [Calendar](#calendar8) | 日历对象。 |
**示例：** **示例：**
```js ```ts
I18n.getCalendar("zh-Hans", "chinese"); // 获取中国农历日历对象 I18n.getCalendar("zh-Hans", "chinese"); // 获取中国农历日历对象
``` ```
...@@ -775,7 +835,7 @@ setTime(date: Date): void ...@@ -775,7 +835,7 @@ setTime(date: Date): void
| date | Date | 是 | 将要设置的日历对象的内部时间日期。 | | date | Date | 是 | 将要设置的日历对象的内部时间日期。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("en-US", "gregory"); let calendar: I18n.Calendar = I18n.getCalendar("en-US", "gregory");
let date: Date = new Date(2021, 10, 7, 8, 0, 0, 0); let date: Date = new Date(2021, 10, 7, 8, 0, 0, 0);
calendar.setTime(date); calendar.setTime(date);
...@@ -797,7 +857,7 @@ setTime(time: number): void ...@@ -797,7 +857,7 @@ setTime(time: number): void
| time | number | 是 | time为从1970.1.1&nbsp;00:00:00&nbsp;GMT逝去的毫秒数。 | | time | number | 是 | time为从1970.1.1&nbsp;00:00:00&nbsp;GMT逝去的毫秒数。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("en-US", "gregory"); let calendar: I18n.Calendar = I18n.getCalendar("en-US", "gregory");
calendar.setTime(10540800000); calendar.setTime(10540800000);
``` ```
...@@ -823,7 +883,7 @@ set(year: number, month: number, date:number, hour?: number, minute?: number, se ...@@ -823,7 +883,7 @@ set(year: number, month: number, date:number, hour?: number, minute?: number, se
| second | number | 否 | 设置的秒。默认值：系统秒。 | | second | number | 否 | 设置的秒。默认值：系统秒。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans"); let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.set(2021, 10, 1, 8, 0, 0); // set time to 2021.10.1 08:00:00 calendar.set(2021, 10, 1, 8, 0, 0); // set time to 2021.10.1 08:00:00
``` ```
...@@ -844,7 +904,7 @@ setTimeZone(timezone: string): void ...@@ -844,7 +904,7 @@ setTimeZone(timezone: string): void
| timezone | string | 是 | 设置的时区id，如“Asia/Shanghai”。 | | timezone | string | 是 | 设置的时区id，如“Asia/Shanghai”。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans"); let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.setTimeZone("Asia/Shanghai"); calendar.setTimeZone("Asia/Shanghai");
``` ```
...@@ -865,7 +925,7 @@ getTimeZone(): string ...@@ -865,7 +925,7 @@ getTimeZone(): string
| string | 日历对象的时区id。 | | string | 日历对象的时区id。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans"); let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.setTimeZone("Asia/Shanghai"); calendar.setTimeZone("Asia/Shanghai");
let timezone: string = calendar.getTimeZone(); // timezone = "Asia/Shanghai" let timezone: string = calendar.getTimeZone(); // timezone = "Asia/Shanghai"
...@@ -887,7 +947,7 @@ getFirstDayOfWeek(): number ...@@ -887,7 +947,7 @@ getFirstDayOfWeek(): number
| number | 获取一周的起始日，1代表周日，7代表周六。 | | number | 获取一周的起始日，1代表周日，7代表周六。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("en-US", "gregory"); let calendar: I18n.Calendar = I18n.getCalendar("en-US", "gregory");
let firstDayOfWeek: number = calendar.getFirstDayOfWeek(); // firstDayOfWeek = 1 let firstDayOfWeek: number = calendar.getFirstDayOfWeek(); // firstDayOfWeek = 1
``` ```
...@@ -908,7 +968,7 @@ setFirstDayOfWeek(value: number): void ...@@ -908,7 +968,7 @@ setFirstDayOfWeek(value: number): void
| value | number | 是 | 设置一周的起始日，1代表周日，7代表周六。 | | value | number | 是 | 设置一周的起始日，1代表周日，7代表周六。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans"); let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.setFirstDayOfWeek(3); calendar.setFirstDayOfWeek(3);
let firstDayOfWeek: number = calendar.getFirstDayOfWeek(); // firstDayOfWeek = 3 let firstDayOfWeek: number = calendar.getFirstDayOfWeek(); // firstDayOfWeek = 3
...@@ -930,7 +990,7 @@ getMinimalDaysInFirstWeek(): number ...@@ -930,7 +990,7 @@ getMinimalDaysInFirstWeek(): number
| number | 一年中第一周的最小天数。 | | number | 一年中第一周的最小天数。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans"); let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
let minimalDaysInFirstWeek: number = calendar.getMinimalDaysInFirstWeek(); // minimalDaysInFirstWeek = 1 let minimalDaysInFirstWeek: number = calendar.getMinimalDaysInFirstWeek(); // minimalDaysInFirstWeek = 1
``` ```
...@@ -951,7 +1011,7 @@ setMinimalDaysInFirstWeek(value: number): void ...@@ -951,7 +1011,7 @@ setMinimalDaysInFirstWeek(value: number): void
| value | number | 是 | 一年中第一周的最小天数。 | | value | number | 是 | 一年中第一周的最小天数。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans"); let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.setMinimalDaysInFirstWeek(3); calendar.setMinimalDaysInFirstWeek(3);
let minimalDaysInFirstWeek: number = calendar.getMinimalDaysInFirstWeek(); // minimalDaysInFirstWeek = 3 let minimalDaysInFirstWeek: number = calendar.getMinimalDaysInFirstWeek(); // minimalDaysInFirstWeek = 3
...@@ -979,7 +1039,7 @@ get(field: string): number ...@@ -979,7 +1039,7 @@ get(field: string): number
| number | 与field相关联的值，如当前Calendar对象的内部日期的年份为1990，get("year")返回1990。 | | number | 与field相关联的值，如当前Calendar对象的内部日期的年份为1990，get("year")返回1990。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans"); let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.set(2021, 10, 1, 8, 0, 0); // set time to 2021.10.1 08:00:00 calendar.set(2021, 10, 1, 8, 0, 0); // set time to 2021.10.1 08:00:00
let hourOfDay: number = calendar.get("hour_of_day"); // hourOfDay = 8 let hourOfDay: number = calendar.get("hour_of_day"); // hourOfDay = 8
...@@ -1007,7 +1067,7 @@ getDisplayName(locale: string): string ...@@ -1007,7 +1067,7 @@ getDisplayName(locale: string): string
| string | 日历在locale所指示的区域的名字。 | | string | 日历在locale所指示的区域的名字。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("en-US", "buddhist"); let calendar: I18n.Calendar = I18n.getCalendar("en-US", "buddhist");
let calendarName: string = calendar.getDisplayName("zh"); // calendarName = "佛历" let calendarName: string = calendar.getDisplayName("zh"); // calendarName = "佛历"
``` ```
...@@ -1034,7 +1094,7 @@ isWeekend(date?: Date): boolean ...@@ -1034,7 +1094,7 @@ isWeekend(date?: Date): boolean
| boolean | 若判断指定日期为周末时，返回true，否则返回false。 | | boolean | 若判断指定日期为周末时，返回true，否则返回false。 |
**示例：** **示例：**
```js ```ts
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans"); let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.set(2021, 11, 11, 8, 0, 0); // set time to 2021.11.11 08:00:00 calendar.set(2021, 11, 11, 8, 0, 0); // set time to 2021.11.11 08:00:00
calendar.isWeekend(); // false calendar.isWeekend(); // false
...@@ -1062,7 +1122,7 @@ constructor(country: string, options?: PhoneNumberFormatOptions) ...@@ -1062,7 +1122,7 @@ constructor(country: string, options?: PhoneNumberFormatOptions)
| options | [PhoneNumberFormatOptions](#phonenumberformatoptions8) | 否 | 电话号码格式化对象的相关选项。默认值：NATIONAL。 | | options | [PhoneNumberFormatOptions](#phonenumberformatoptions8) | 否 | 电话号码格式化对象的相关选项。默认值：NATIONAL。 |
**示例：** **示例：**
```js ```ts
let option: I18n.PhoneNumberFormatOptions = {type: "E164"}; let option: I18n.PhoneNumberFormatOptions = {type: "E164"};
let phoneNumberFormat: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN", option); let phoneNumberFormat: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN", option);
``` ```
...@@ -1089,7 +1149,7 @@ isValidNumber(number: string): boolean ...@@ -1089,7 +1149,7 @@ isValidNumber(number: string): boolean
| boolean | 返回true表示电话号码的格式正确，返回false表示电话号码的格式错误。 | | boolean | 返回true表示电话号码的格式正确，返回false表示电话号码的格式错误。 |
**示例：** **示例：**
```js ```ts
let phonenumberfmt: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN"); let phonenumberfmt: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN");
let isValidNumber: boolean = phonenumberfmt.isValidNumber("15812312312"); // isValidNumber = true let isValidNumber: boolean = phonenumberfmt.isValidNumber("15812312312"); // isValidNumber = true
``` ```
...@@ -1116,7 +1176,7 @@ format(number: string): string ...@@ -1116,7 +1176,7 @@ format(number: string): string
| string | 格式化后的电话号码。 | | string | 格式化后的电话号码。 |
**示例：** **示例：**
```js ```ts
let phonenumberfmt: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN"); let phonenumberfmt: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN");
let formattedPhoneNumber: string = phonenumberfmt.format("15812312312"); // formattedPhoneNumber = "158 1231 2312" let formattedPhoneNumber: string = phonenumberfmt.format("15812312312"); // formattedPhoneNumber = "158 1231 2312"
``` ```
...@@ -1144,7 +1204,7 @@ getLocationName(number: string, locale: string): string ...@@ -1144,7 +1204,7 @@ getLocationName(number: string, locale: string): string
| string | 电话号码归属地。 | | string | 电话号码归属地。 |
**示例：** **示例：**
```js ```ts
let phonenumberfmt: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN"); let phonenumberfmt: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN");
let locationName: string = phonenumberfmt.getLocationName("15812312345", "zh-CN"); // locationName = "广东省湛江市" let locationName: string = phonenumberfmt.getLocationName("15812312345", "zh-CN"); // locationName = "广东省湛江市"
``` ```
...@@ -1194,7 +1254,7 @@ getInstance(locale?:string): IndexUtil ...@@ -1194,7 +1254,7 @@ getInstance(locale?:string): IndexUtil
| [IndexUtil](#indexutil8) | locale对应的IndexUtil对象。 | | [IndexUtil](#indexutil8) | locale对应的IndexUtil对象。 |
**示例：** **示例：**
```js ```ts
let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN"); let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN");
``` ```
...@@ -1217,7 +1277,7 @@ getIndexList(): Array&lt;string&gt; ...@@ -1217,7 +1277,7 @@ getIndexList(): Array&lt;string&gt;
| Array&lt;string&gt; | 返回当前locale对应的索引列表。 | | Array&lt;string&gt; | 返回当前locale对应的索引列表。 |
**示例：** **示例：**
```js ```ts
let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN"); let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN");
// indexList = [ "...", "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", // indexList = [ "...", "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N",
// "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z", "..." ] // "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z", "..." ]
...@@ -1240,7 +1300,7 @@ addLocale(locale: string): void ...@@ -1240,7 +1300,7 @@ addLocale(locale: string): void
| locale | string | 是 | 区域设置信息的字符串，包括语言以及可选的脚本和区域。 | | locale | string | 是 | 区域设置信息的字符串，包括语言以及可选的脚本和区域。 |
**示例：** **示例：**
```js ```ts
let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN"); let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN");
indexUtil.addLocale("en-US"); indexUtil.addLocale("en-US");
``` ```
...@@ -1267,7 +1327,7 @@ getIndex(text: string): string ...@@ -1267,7 +1327,7 @@ getIndex(text: string): string
| string | 输入文本对应的索引值。 | | string | 输入文本对应的索引值。 |
**示例：** **示例：**
```js ```ts
let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN"); let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN");
let index: string = indexUtil.getIndex("hi"); // index = "H" let index: string = indexUtil.getIndex("hi"); // index = "H"
``` ```
...@@ -1294,7 +1354,7 @@ getLineInstance(locale: string): BreakIterator ...@@ -1294,7 +1354,7 @@ getLineInstance(locale: string): BreakIterator
| [BreakIterator](#breakiterator8) | 用于进行断句的处理器。 | | [BreakIterator](#breakiterator8) | 用于进行断句的处理器。 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
``` ```
...@@ -1317,7 +1377,7 @@ setLineBreakText(text: string): void ...@@ -1317,7 +1377,7 @@ setLineBreakText(text: string): void
| text | string | 是 | 指定BreakIterator进行断句的文本。 | | text | string | 是 | 指定BreakIterator进行断句的文本。 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); // 设置短句文本 iterator.setLineBreakText("Apple is my favorite fruit."); // 设置短句文本
``` ```
...@@ -1338,7 +1398,7 @@ getLineBreakText(): string ...@@ -1338,7 +1398,7 @@ getLineBreakText(): string
| string | BreakIterator对象正在处理的文本 | | string | BreakIterator对象正在处理的文本 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); iterator.setLineBreakText("Apple is my favorite fruit.");
let breakText: string = iterator.getLineBreakText(); // breakText = "Apple is my favorite fruit." let breakText: string = iterator.getLineBreakText(); // breakText = "Apple is my favorite fruit."
...@@ -1360,7 +1420,7 @@ current(): number ...@@ -1360,7 +1420,7 @@ current(): number
| number | BreakIterator在当前所处理的文本中的位置。 | | number | BreakIterator在当前所处理的文本中的位置。 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); iterator.setLineBreakText("Apple is my favorite fruit.");
let currentPos: number = iterator.current(); // currentPos = 0 let currentPos: number = iterator.current(); // currentPos = 0
...@@ -1382,7 +1442,7 @@ first(): number ...@@ -1382,7 +1442,7 @@ first(): number
| number | 被处理文本的第一个分割点的偏移量。 | | number | 被处理文本的第一个分割点的偏移量。 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); iterator.setLineBreakText("Apple is my favorite fruit.");
let firstPos: number = iterator.first(); // firstPos = 0 let firstPos: number = iterator.first(); // firstPos = 0
...@@ -1404,7 +1464,7 @@ last(): number ...@@ -1404,7 +1464,7 @@ last(): number
| number | 被处理的文本的最后一个分割点的偏移量 | | number | 被处理的文本的最后一个分割点的偏移量 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); iterator.setLineBreakText("Apple is my favorite fruit.");
let lastPos: number = iterator.last(); // lastPos = 27 let lastPos: number = iterator.last(); // lastPos = 27
...@@ -1432,7 +1492,7 @@ next(index?: number): number ...@@ -1432,7 +1492,7 @@ next(index?: number): number
| number | 返回移动了index个分割点后，当前BreakIterator在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-1。 | | number | 返回移动了index个分割点后，当前BreakIterator在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-1。 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); iterator.setLineBreakText("Apple is my favorite fruit.");
let pos: number = iterator.first(); // pos = 0 let pos: number = iterator.first(); // pos = 0
...@@ -1456,7 +1516,7 @@ previous(): number ...@@ -1456,7 +1516,7 @@ previous(): number
| number | 返回移动到前一个分割点后，当前BreakIterator在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-1。 | | number | 返回移动到前一个分割点后，当前BreakIterator在文本中的位置。若移动index个分割点后超出了所处理的文本的长度范围，返回-1。 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); iterator.setLineBreakText("Apple is my favorite fruit.");
let pos: number = iterator.first(); // pos = 0 let pos: number = iterator.first(); // pos = 0
...@@ -1486,7 +1546,7 @@ following(offset: number): number ...@@ -1486,7 +1546,7 @@ following(offset: number): number
| number | 返回BreakIterator移动后的位置，如果由offset所指定的位置的下一个分割点超出了文本的范围则返回-1。 | | number | 返回BreakIterator移动后的位置，如果由offset所指定的位置的下一个分割点超出了文本的范围则返回-1。 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); iterator.setLineBreakText("Apple is my favorite fruit.");
let pos: number = iterator.following(0); // pos = 6 let pos: number = iterator.following(0); // pos = 6
...@@ -1516,7 +1576,7 @@ isBoundary(offset: number): boolean ...@@ -1516,7 +1576,7 @@ isBoundary(offset: number): boolean
| boolean | 如果是一个分割点返回true,&nbsp;否则返回false。 | | boolean | 如果是一个分割点返回true,&nbsp;否则返回false。 |
**示例：** **示例：**
```js ```ts
let iterator: I18n.BreakIterator = I18n.getLineInstance("en"); let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); iterator.setLineBreakText("Apple is my favorite fruit.");
let isBoundary: boolean = iterator.isBoundary(0); // isBoundary = true; let isBoundary: boolean = iterator.isBoundary(0); // isBoundary = true;
...@@ -1545,7 +1605,7 @@ getTimeZone(zoneID?: string): TimeZone ...@@ -1545,7 +1605,7 @@ getTimeZone(zoneID?: string): TimeZone
| TimeZone | 时区ID对应的时区对象。 | | TimeZone | 时区ID对应的时区对象。 |
**示例：** **示例：**
```js ```ts
let timezone: I18n.TimeZone = I18n.getTimeZone(); let timezone: I18n.TimeZone = I18n.getTimeZone();
``` ```
...@@ -1568,7 +1628,7 @@ getID(): string ...@@ -1568,7 +1628,7 @@ getID(): string
| string | 时区对象对应的时区ID。 | | string | 时区对象对应的时区ID。 |
**示例：** **示例：**
```js ```ts
let timezone: I18n.TimeZone = I18n.getTimeZone(); let timezone: I18n.TimeZone = I18n.getTimeZone();
let timezoneID: string = timezone.getID(); // timezoneID = "Asia/Shanghai" let timezoneID: string = timezone.getID(); // timezoneID = "Asia/Shanghai"
``` ```
...@@ -1596,7 +1656,7 @@ getDisplayName(locale?: string, isDST?: boolean): string ...@@ -1596,7 +1656,7 @@ getDisplayName(locale?: string, isDST?: boolean): string
| string | 时区对象在指定区域的表示。 | | string | 时区对象在指定区域的表示。 |
**示例：** **示例：**
```js ```ts
let timezone: I18n.TimeZone = I18n.getTimeZone(); let timezone: I18n.TimeZone = I18n.getTimeZone();
let timezoneName: string = timezone.getDisplayName("zh-CN", false); // timezoneName = "中国标准时间" let timezoneName: string = timezone.getDisplayName("zh-CN", false); // timezoneName = "中国标准时间"
``` ```
...@@ -1617,7 +1677,7 @@ getRawOffset(): number ...@@ -1617,7 +1677,7 @@ getRawOffset(): number
| number | 时区对象表示的时区与UTC时区的偏差。 | | number | 时区对象表示的时区与UTC时区的偏差。 |
**示例：** **示例：**
```js ```ts
let timezone: I18n.TimeZone = I18n.getTimeZone(); let timezone: I18n.TimeZone = I18n.getTimeZone();
let offset: number = timezone.getRawOffset(); // offset = 28800000 let offset: number = timezone.getRawOffset(); // offset = 28800000
``` ```
...@@ -1638,7 +1698,7 @@ getOffset(date?: number): number ...@@ -1638,7 +1698,7 @@ getOffset(date?: number): number
| number | 某一时刻时区对象表示的时区与UTC时区的偏差。默认值：系统时间。 | | number | 某一时刻时区对象表示的时区与UTC时区的偏差。默认值：系统时间。 |
**示例：** **示例：**
```js ```ts
let timezone: I18n.TimeZone = I18n.getTimeZone(); let timezone: I18n.TimeZone = I18n.getTimeZone();
let offset: number = timezone.getOffset(1234567890); // offset = 28800000 let offset: number = timezone.getOffset(1234567890); // offset = 28800000
``` ```
...@@ -1760,7 +1820,7 @@ static getTimezonesByLocation(longitude: number, latitude: number): Array&lt;Tim ...@@ -1760,7 +1820,7 @@ static getTimezonesByLocation(longitude: number, latitude: number): Array&lt;Tim
| Array&lt;[TimeZone](#timezone)&gt; | 时区对象的数组 | | Array&lt;[TimeZone](#timezone)&gt; | 时区对象的数组 |
**示例：** **示例：**
```js ```ts
let timezoneArray: Array<I18n.TimeZone> = I18n.TimeZone.getTimezonesByLocation(-118.1, 34.0); let timezoneArray: Array<I18n.TimeZone> = I18n.TimeZone.getTimezonesByLocation(-118.1, 34.0);
for (let i = 0; i < timezoneArray.length; i++) { for (let i = 0; i < timezoneArray.length; i++) {
let tzId: string = timezoneArray[i].getID(); let tzId: string = timezoneArray[i].getID();
...@@ -1870,7 +1930,7 @@ static isDigit(char: string): boolean ...@@ -1870,7 +1930,7 @@ static isDigit(char: string): boolean
| boolean | 返回true表示输入的字符是数字，返回false表示输入的字符不是数字。 | | boolean | 返回true表示输入的字符是数字，返回false表示输入的字符不是数字。 |
**示例：** **示例：**
```js ```ts
let isdigit: boolean = I18n.Unicode.isDigit("1"); // isdigit = true let isdigit: boolean = I18n.Unicode.isDigit("1"); // isdigit = true
``` ```
...@@ -1896,7 +1956,7 @@ static isSpaceChar(char: string): boolean ...@@ -1896,7 +1956,7 @@ static isSpaceChar(char: string): boolean
| boolean | 返回true表示输入的字符是空格符，返回false表示输入的字符不是空格符。 | | boolean | 返回true表示输入的字符是空格符，返回false表示输入的字符不是空格符。 |
**示例：** **示例：**
```js ```ts
let isspacechar: boolean = I18n.Unicode.isSpaceChar("a"); // isspacechar = false let isspacechar: boolean = I18n.Unicode.isSpaceChar("a"); // isspacechar = false
``` ```
...@@ -1922,7 +1982,7 @@ static isWhitespace(char: string): boolean ...@@ -1922,7 +1982,7 @@ static isWhitespace(char: string): boolean
| boolean | 返回true表示输入的字符是空白符，返回false表示输入的字符不是空白符。 | | boolean | 返回true表示输入的字符是空白符，返回false表示输入的字符不是空白符。 |
**示例：** **示例：**
```js ```ts
let iswhitespace: boolean = I18n.Unicode.isWhitespace("a"); // iswhitespace = false let iswhitespace: boolean = I18n.Unicode.isWhitespace("a"); // iswhitespace = false
``` ```
...@@ -1948,7 +2008,7 @@ static isRTL(char: string): boolean ...@@ -1948,7 +2008,7 @@ static isRTL(char: string): boolean
| boolean | 返回true表示输入的字符是从右到左语言的字符，返回false表示输入的字符不是从右到左语言的字符。 | | boolean | 返回true表示输入的字符是从右到左语言的字符，返回false表示输入的字符不是从右到左语言的字符。 |
**示例：** **示例：**
```js ```ts
let isrtl: boolean = I18n.Unicode.isRTL("a"); // isrtl = false let isrtl: boolean = I18n.Unicode.isRTL("a"); // isrtl = false
``` ```
...@@ -1974,7 +2034,7 @@ static isIdeograph(char: string): boolean ...@@ -1974,7 +2034,7 @@ static isIdeograph(char: string): boolean
| boolean | 返回true表示输入的字符是表意文字，返回false表示输入的字符不是表意文字。 | | boolean | 返回true表示输入的字符是表意文字，返回false表示输入的字符不是表意文字。 |
**示例：** **示例：**
```js ```ts
let isideograph: boolean = I18n.Unicode.isIdeograph("a"); // isideograph = false let isideograph: boolean = I18n.Unicode.isIdeograph("a"); // isideograph = false
``` ```
...@@ -2000,7 +2060,7 @@ static isLetter(char: string): boolean ...@@ -2000,7 +2060,7 @@ static isLetter(char: string): boolean
| boolean | 返回true表示输入的字符是字母，返回false表示输入的字符不是字母。 | | boolean | 返回true表示输入的字符是字母，返回false表示输入的字符不是字母。 |
**示例：** **示例：**
```js ```ts
let isletter: boolean = I18n.Unicode.isLetter("a"); // isletter = true let isletter: boolean = I18n.Unicode.isLetter("a"); // isletter = true
``` ```
...@@ -2026,7 +2086,7 @@ static isLowerCase(char: string): boolean ...@@ -2026,7 +2086,7 @@ static isLowerCase(char: string): boolean
| boolean | 返回true表示输入的字符是小写字母，返回false表示输入的字符不是小写字母。 | | boolean | 返回true表示输入的字符是小写字母，返回false表示输入的字符不是小写字母。 |
**示例：** **示例：**
```js ```ts
let islowercase: boolean = I18n.Unicode.isLowerCase("a"); // islowercase = true let islowercase: boolean = I18n.Unicode.isLowerCase("a"); // islowercase = true
``` ```
...@@ -2052,7 +2112,7 @@ static isUpperCase(char: string): boolean ...@@ -2052,7 +2112,7 @@ static isUpperCase(char: string): boolean
| boolean | 返回true表示输入的字符是大写字母，返回false表示输入的字符不是大写字母。 | | boolean | 返回true表示输入的字符是大写字母，返回false表示输入的字符不是大写字母。 |
**示例：** **示例：**
```js ```ts
let isuppercase: boolean = I18n.Unicode.isUpperCase("a"); // isuppercase = false let isuppercase: boolean = I18n.Unicode.isUpperCase("a"); // isuppercase = false
``` ```
...@@ -2114,7 +2174,7 @@ static getType(char: string): string ...@@ -2114,7 +2174,7 @@ static getType(char: string): string
| U_OTHER_SYMBOL | U_OTHER_SYMBOL | 表示其它符号。 | | U_OTHER_SYMBOL | U_OTHER_SYMBOL | 表示其它符号。 |
**示例：** **示例：**
```js ```ts
let type: string = I18n.Unicode.getType("a"); // type = "U_LOWERCASE_LETTER" let type: string = I18n.Unicode.getType("a"); // type = "U_LOWERCASE_LETTER"
``` ```
...@@ -2146,8 +2206,10 @@ static unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale: ...@@ -2146,8 +2206,10 @@ static unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale:
| string | 按照toUnit的单位格式化后，得到的字符串。 | | string | 按照toUnit的单位格式化后，得到的字符串。 |
**示例：** **示例：**
```js ```ts
let res: string = I18n.I18NUtil.unitConvert({unit: "cup", measureSystem: "US"}, {unit: "liter", measureSystem: "SI"}, 1000, "en-US", "long"); // res = 236.588 liters let fromUnit: I18n.UnitInfo = {unit: "cup", measureSystem: "US"};
let toUnit: I18n.UnitInfo = {unit: "liter", measureSystem: "SI"};
let res: string = I18n.I18NUtil.unitConvert(fromUnit, toUnit, 1000, "en-US", "long"); // res = 236.588 liters
``` ```
...@@ -2172,7 +2234,7 @@ static getDateOrder(locale: string): string ...@@ -2172,7 +2234,7 @@ static getDateOrder(locale: string): string
| string | 返回该区域年、月、日的排列顺序。 | | string | 返回该区域年、月、日的排列顺序。 |
**示例：** **示例：**
```js ```ts
let order: string = I18n.I18NUtil.getDateOrder("zh-CN"); // order = "y-L-d" let order: string = I18n.I18NUtil.getDateOrder("zh-CN"); // order = "y-L-d"
``` ```
...@@ -2200,7 +2262,7 @@ static getInstance(mode: NormalizerMode): Normalizer ...@@ -2200,7 +2262,7 @@ static getInstance(mode: NormalizerMode): Normalizer
| [Normalizer](#normalizer10) | 返回指定范式的文本正则化对象。 | | [Normalizer](#normalizer10) | 返回指定范式的文本正则化对象。 |
**示例：** **示例：**
```js ```ts
let normalizer: I18n.Normalizer = I18n.Normalizer.getInstance(I18n.NormalizerMode.NFC); let normalizer: I18n.Normalizer = I18n.Normalizer.getInstance(I18n.NormalizerMode.NFC);
``` ```
...@@ -2226,7 +2288,7 @@ normalize(text: string): string ...@@ -2226,7 +2288,7 @@ normalize(text: string): string
| string | 正则化后的字符串。 | | string | 正则化后的字符串。 |
**示例：** **示例：**
```js ```ts
let normalizer: I18n.Normalizer = I18n.Normalizer.getInstance(I18n.NormalizerMode.NFC); let normalizer: I18n.Normalizer = I18n.Normalizer.getInstance(I18n.NormalizerMode.NFC);
let normalizedText: string = normalizer.normalize('\u1E9B\u0323'); // normalizedText = \u1E9B\u0323 let normalizedText: string = normalizer.normalize('\u1E9B\u0323'); // normalizedText = \u1E9B\u0323
``` ```
...@@ -2260,7 +2322,7 @@ constructor() ...@@ -2260,7 +2322,7 @@ constructor()
**系统能力**：SystemCapability.Global.I18n **系统能力**：SystemCapability.Global.I18n
**示例：** **示例：**
```js ```ts
let systemLocaleManager: I18n.SystemLocaleManager = new I18n.SystemLocaleManager(); let systemLocaleManager: I18n.SystemLocaleManager = new I18n.SystemLocaleManager();
``` ```
...@@ -2297,7 +2359,9 @@ getLanguageInfoArray(languages: Array&lt;string&gt;, options?: SortOptions): Arr ...@@ -2297,7 +2359,9 @@ getLanguageInfoArray(languages: Array&lt;string&gt;, options?: SortOptions): Arr
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
// 当系统语言为zh-Hans，系统地区为CN，系统Locale为zh-Hans-CN时 // 当系统语言为zh-Hans，系统地区为CN，系统Locale为zh-Hans-CN时
let systemLocaleManager: I18n.SystemLocaleManager = new I18n.SystemLocaleManager(); let systemLocaleManager: I18n.SystemLocaleManager = new I18n.SystemLocaleManager();
let languages: string[] = ["zh-Hans", "en-US", "pt", "ar"]; let languages: string[] = ["zh-Hans", "en-US", "pt", "ar"];
...@@ -2306,7 +2370,8 @@ getLanguageInfoArray(languages: Array&lt;string&gt;, options?: SortOptions): Arr ...@@ -2306,7 +2370,8 @@ getLanguageInfoArray(languages: Array&lt;string&gt;, options?: SortOptions): Arr
// 排序后的语言顺序为: [zh-Hans, en-US, pt, ar] // 排序后的语言顺序为: [zh-Hans, en-US, pt, ar]
let sortedLanguages: Array<I18n.LocaleItem> = systemLocaleManager.getLanguageInfoArray(languages, sortOptions); let sortedLanguages: Array<I18n.LocaleItem> = systemLocaleManager.getLanguageInfoArray(languages, sortOptions);
} catch(error) { } catch(error) {
console.error(`call systemLocaleManager.getLanguageInfoArray failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -2343,7 +2408,9 @@ getRegionInfoArray(regions: Array&lt;string&gt;, options?: SortOptions): Array&l ...@@ -2343,7 +2408,9 @@ getRegionInfoArray(regions: Array&lt;string&gt;, options?: SortOptions): Array&l
| 890001 | param value not valid | | 890001 | param value not valid |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
// 当系统语言为zh-Hans，系统地区为CN，系统Locale为zh-Hans-CN时 // 当系统语言为zh-Hans，系统地区为CN，系统Locale为zh-Hans-CN时
let systemLocaleManager: I18n.SystemLocaleManager = new I18n.SystemLocaleManager(); let systemLocaleManager: I18n.SystemLocaleManager = new I18n.SystemLocaleManager();
let regions: string[] = ["CN", "US", "PT", "EG"]; let regions: string[] = ["CN", "US", "PT", "EG"];
...@@ -2352,7 +2419,8 @@ getRegionInfoArray(regions: Array&lt;string&gt;, options?: SortOptions): Array&l ...@@ -2352,7 +2419,8 @@ getRegionInfoArray(regions: Array&lt;string&gt;, options?: SortOptions): Array&l
// 排序后的地区顺序为: [CN, EG, US, PT] // 排序后的地区顺序为: [CN, EG, US, PT]
let sortedRegions: Array<I18n.LocaleItem> = systemLocaleManager.getRegionInfoArray(regions, sortOptions); let sortedRegions: Array<I18n.LocaleItem> = systemLocaleManager.getRegionInfoArray(regions, sortOptions);
} catch(error) { } catch(error) {
console.error(`call systemLocaleManager.getRegionInfoArray failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -2373,7 +2441,9 @@ static getTimeZoneCityItemArray(): Array&lt;TimeZoneCityItem&gt; ...@@ -2373,7 +2441,9 @@ static getTimeZoneCityItemArray(): Array&lt;TimeZoneCityItem&gt;
| Array&lt;[TimeZoneCityItem](#timezonecityitem10)&gt; | 排序后的时区城市组合信息的数组。 | | Array&lt;[TimeZoneCityItem](#timezonecityitem10)&gt; | 排序后的时区城市组合信息的数组。 |
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
try { try {
let timeZoneCityItemArray: Array<I18n.TimeZoneCityItem> = I18n.SystemLocaleManager.getTimeZoneCityItemArray(); let timeZoneCityItemArray: Array<I18n.TimeZoneCityItem> = I18n.SystemLocaleManager.getTimeZoneCityItemArray();
for (let i = 0; i < timeZoneCityItemArray.length; i++) { for (let i = 0; i < timeZoneCityItemArray.length; i++) {
...@@ -2381,7 +2451,8 @@ static getTimeZoneCityItemArray(): Array&lt;TimeZoneCityItem&gt; ...@@ -2381,7 +2451,8 @@ static getTimeZoneCityItemArray(): Array&lt;TimeZoneCityItem&gt;
", " + timeZoneCityItemArray[i].offset + "\r\n"); ", " + timeZoneCityItemArray[i].offset + "\r\n");
} }
} catch(error) { } catch(error) {
console.error(`call SystemLocaleManager.getTimeZoneCityItemArray failed, error code: ${error.code}, message: ${error.message}.`); let err: BusinessError = error as BusinessError;
console.error(`call System.getDisplayCountry failed, error code: ${err.code}, message: ${err.message}.`);
} }
``` ```
...@@ -2473,7 +2544,7 @@ getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): stri ...@@ -2473,7 +2544,7 @@ getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): stri
| string | 指定国家的本地化显示文本。 | | string | 指定国家的本地化显示文本。 |
**示例：** **示例：**
```js ```ts
let countryName: string = I18n.getDisplayCountry("zh-CN", "en-GB", true); // countryName = true let countryName: string = I18n.getDisplayCountry("zh-CN", "en-GB", true); // countryName = true
countryName = I18n.getDisplayCountry("zh-CN", "en-GB"); // countryName = true countryName = I18n.getDisplayCountry("zh-CN", "en-GB"); // countryName = true
``` ```
...@@ -2504,7 +2575,7 @@ getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): st ...@@ -2504,7 +2575,7 @@ getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): st
| string | 指定语言的本地化显示文本。 | | string | 指定语言的本地化显示文本。 |
**示例：** **示例：**
```js ```ts
let languageName: string = I18n.getDisplayLanguage("zh", "en-GB", true); // languageName = "Chinese" let languageName: string = I18n.getDisplayLanguage("zh", "en-GB", true); // languageName = "Chinese"
languageName = I18n.getDisplayLanguage("zh", "en-GB"); // languageName = "Chinese" languageName = I18n.getDisplayLanguage("zh", "en-GB"); // languageName = "Chinese"
``` ```
...@@ -2527,7 +2598,7 @@ getSystemLanguage(): string ...@@ -2527,7 +2598,7 @@ getSystemLanguage(): string
| string | 系统语言ID。 | | string | 系统语言ID。 |
**示例：** **示例：**
```js ```ts
let systemLanguage: string = I18n.getSystemLanguage(); // 返回当前系统语言 let systemLanguage: string = I18n.getSystemLanguage(); // 返回当前系统语言
``` ```
...@@ -2549,7 +2620,7 @@ getSystemRegion(): string ...@@ -2549,7 +2620,7 @@ getSystemRegion(): string
| string | 系统地区ID。 | | string | 系统地区ID。 |
**示例：** **示例：**
```js ```ts
let region: string = I18n.getSystemRegion(); // 返回当前系统地区 let region: string = I18n.getSystemRegion(); // 返回当前系统地区
``` ```
...@@ -2571,7 +2642,7 @@ getSystemLocale(): string ...@@ -2571,7 +2642,7 @@ getSystemLocale(): string
| string | 系统区域ID。 | | string | 系统区域ID。 |
**示例：** **示例：**
```js ```ts
let locale: string = I18n.getSystemLocale(); // 返回系统Locale let locale: string = I18n.getSystemLocale(); // 返回系统Locale
``` ```
...@@ -2593,7 +2664,7 @@ is24HourClock(): boolean ...@@ -2593,7 +2664,7 @@ is24HourClock(): boolean
| boolean | 返回true，表示系统24小时开关开启；返回false，表示系统24小时开关关闭。 | | boolean | 返回true，表示系统24小时开关开启；返回false，表示系统24小时开关关闭。 |
**示例：** **示例：**
```js ```ts
let is24HourClock: boolean = I18n.is24HourClock(); let is24HourClock: boolean = I18n.is24HourClock();
``` ```
...@@ -2623,7 +2694,7 @@ set24HourClock(option: boolean): boolean ...@@ -2623,7 +2694,7 @@ set24HourClock(option: boolean): boolean
| boolean | 返回true，表示修改成功；返回false，表示修改失败。 | | boolean | 返回true，表示修改成功；返回false，表示修改失败。 |
**示例：** **示例：**
```js ```ts
// 将系统时间设置为24小时制 // 将系统时间设置为24小时制
let success: boolean = I18n.set24HourClock(true); let success: boolean = I18n.set24HourClock(true);
``` ```
...@@ -2655,7 +2726,7 @@ addPreferredLanguage(language: string, index?: number): boolean ...@@ -2655,7 +2726,7 @@ addPreferredLanguage(language: string, index?: number): boolean
| boolean | 返回true，表示添加成功；返回false，表示添加失败。 | | boolean | 返回true，表示添加成功；返回false，表示添加失败。 |
**示例：** **示例：**
```js ```ts
// 将语言zh-CN添加到系统偏好语言列表中 // 将语言zh-CN添加到系统偏好语言列表中
let language: string = 'zh-CN'; let language: string = 'zh-CN';
let index: number = 0; let index: number = 0;
...@@ -2688,7 +2759,7 @@ removePreferredLanguage(index: number): boolean ...@@ -2688,7 +2759,7 @@ removePreferredLanguage(index: number): boolean
| boolean | 返回true，表示删除成功；返回false，表示删除失败。 | | boolean | 返回true，表示删除成功；返回false，表示删除失败。 |
**示例：** **示例：**
```js ```ts
// 删除系统偏好语言列表中的第一个偏好语言 // 删除系统偏好语言列表中的第一个偏好语言
let index: number = 0; let index: number = 0;
let success: boolean = I18n.removePreferredLanguage(index); let success: boolean = I18n.removePreferredLanguage(index);
...@@ -2712,7 +2783,7 @@ getPreferredLanguageList(): Array&lt;string&gt; ...@@ -2712,7 +2783,7 @@ getPreferredLanguageList(): Array&lt;string&gt;
| Array&lt;string&gt; | 系统偏好语言列表。 | | Array&lt;string&gt; | 系统偏好语言列表。 |
**示例：** **示例：**
```js ```ts
let preferredLanguageList: Array<string> = I18n.getPreferredLanguageList(); // 获取系统偏好语言列表 let preferredLanguageList: Array<string> = I18n.getPreferredLanguageList(); // 获取系统偏好语言列表
``` ```
...@@ -2734,7 +2805,7 @@ getFirstPreferredLanguage(): string ...@@ -2734,7 +2805,7 @@ getFirstPreferredLanguage(): string
| string | 偏好语言列表中的第一个语言。 | | string | 偏好语言列表中的第一个语言。 |
**示例：** **示例：**
```js ```ts
let firstPreferredLanguage: string = I18n.getFirstPreferredLanguage(); let firstPreferredLanguage: string = I18n.getFirstPreferredLanguage();
``` ```
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或