Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
未验证 提交 5e80b054 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!22681 I18n文档中ArkTS语法规范整改 

Merge pull request !22681 from W.J/master
上级 cd6f5eaf b2c5a338
显示空白变更内容
内联 并排
Showing with 370 addition and 369 deletion
zh-cn/application-dev/reference/apis/js-apis-i18n.md
浏览文件 @ 5e80b054
......@@ -51,8 +51,8 @@ static getDisplayCountry(country: string, locale: string, sentenceCase?: boolean
**示例：**
```js
try {
let displayCountry = I18n.System.getDisplayCountry("zh-CN", "en-GB"); // displayCountry = "China"
} catch(error) {
let displayCountry: string = I18n.System.getDisplayCountry("zh-CN", "en-GB"); // displayCountry = "China"
} catch (error) {
console.error(`call System.getDisplayCountry failed, error code: ${error.code}, message: ${error.message}.`);
}
```
......@@ -90,7 +90,7 @@ static getDisplayLanguage(language: string, locale: string, sentenceCase?: boole
**示例：**
```js
try {
let displayLanguage = I18n.System.getDisplayLanguage("zh", "en-GB"); // displayLanguage = Chinese
let displayLanguage: string = I18n.System.getDisplayLanguage("zh", "en-GB"); // displayLanguage = Chinese
} catch(error) {
console.error(`call System.getDisplayLanguage failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -121,7 +121,7 @@ static getSystemLanguages(): Array<string>
**示例：**
```js
try {
let systemLanguages = I18n.System.getSystemLanguages(); // [ "en-Latn-US", "zh-Hans" ]
let systemLanguages: Array<string> = I18n.System.getSystemLanguages(); // [ "en-Latn-US", "zh-Hans" ]
} catch(error) {
console.error(`call System.getSystemLanguages failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -158,7 +158,7 @@ static getSystemCountries(language: string): Array&lt;string&gt;
**示例：**
```js
try {
let systemCountries = 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) {
console.error(`call System.getSystemCountries failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -196,7 +196,7 @@ static isSuggested(language: string, region?: string): boolean
**示例：**
```js
try {
let res = I18n.System.isSuggested('zh', 'CN'); // res = true
let res: boolean = I18n.System.isSuggested('zh', 'CN'); // res = true
} catch(error) {
console.error(`call System.isSuggested failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -227,7 +227,7 @@ static getSystemLanguage(): string
**示例：**
```js
try {
let systemLanguage = I18n.System.getSystemLanguage(); // systemLanguage为当前系统语言
let systemLanguage: string = I18n.System.getSystemLanguage(); // systemLanguage为当前系统语言
} catch(error) {
console.error(`call System.getSystemLanguage failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -293,7 +293,7 @@ static getSystemRegion(): string
**示例：**
```js
try {
let systemRegion = I18n.System.getSystemRegion(); // 获取系统当前地区设置
let systemRegion: string = I18n.System.getSystemRegion(); // 获取系统当前地区设置
} catch(error) {
console.error(`call System.getSystemRegion failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -359,7 +359,7 @@ static getSystemLocale(): string
**示例：**
```js
try {
let systemLocale = I18n.System.getSystemLocale(); // 获取系统当前Locale
let systemLocale: string = I18n.System.getSystemLocale(); // 获取系统当前Locale
} catch(error) {
console.error(`call System.getSystemLocale failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -425,7 +425,7 @@ static is24HourClock(): boolean
**示例：**
```js
try {
let is24HourClock = I18n.System.is24HourClock(); // 系统24小时开关是否开启
let is24HourClock: boolean = I18n.System.is24HourClock(); // 系统24小时开关是否开启
} catch(error) {
console.error(`call System.is24HourClock failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -535,7 +535,7 @@ static removePreferredLanguage(index: number): void
**示例：**
```js
// 删除系统偏好语言列表中的第一个偏好语言
let index = 0;
let index: number = 0;
try {
I18n.System.removePreferredLanguage(index);
} catch(error) {
......@@ -568,7 +568,7 @@ static getPreferredLanguageList(): Array&lt;string&gt;
**示例：**
```js
try {
let preferredLanguageList = I18n.System.getPreferredLanguageList(); // 获取系统当前偏好语言列表
let preferredLanguageList: Array<string> = I18n.System.getPreferredLanguageList(); // 获取系统当前偏好语言列表
} catch(error) {
console.error(`call System.getPreferredLanguageList failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -599,7 +599,7 @@ static getFirstPreferredLanguage(): string
**示例：**
```js
try {
let firstPreferredLanguage = I18n.System.getFirstPreferredLanguage(); // 获取系统当前偏好语言列表中的第一个偏好语言
let firstPreferredLanguage: string = I18n.System.getFirstPreferredLanguage(); // 获取系统当前偏好语言列表中的第一个偏好语言
} catch(error) {
console.error(`call System.getFirstPreferredLanguage failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -630,7 +630,7 @@ static getAppPreferredLanguage(): string
**示例：**
```js
try {
let appPreferredLanguage = I18n.System.getAppPreferredLanguage(); // 获取应用偏好语言
let appPreferredLanguage: string = I18n.System.getAppPreferredLanguage(); // 获取应用偏好语言
} catch(error) {
console.error(`call System.getAppPreferredLanguage failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -696,7 +696,7 @@ static getUsingLocalDigit(): boolean
**示例：**
```ts
try {
let status = I18n.System.getUsingLocalDigit(); // 判断本地化数字开关是否打开
let status: boolean = I18n.System.getUsingLocalDigit(); // 判断本地化数字开关是否打开
} catch(error) {
console.error(`call System.getUsingLocalDigit failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -776,8 +776,8 @@ setTime(date: Date): void
**示例：**
```js
let calendar = I18n.getCalendar("en-US", "gregory");
let date = new Date(2021, 10, 7, 8, 0, 0, 0);
let calendar: I18n.Calendar = I18n.getCalendar("en-US", "gregory");
let date: Date = new Date(2021, 10, 7, 8, 0, 0, 0);
calendar.setTime(date);
```
......@@ -798,7 +798,7 @@ setTime(time: number): void
**示例：**
```js
let calendar = I18n.getCalendar("en-US", "gregory");
let calendar: I18n.Calendar = I18n.getCalendar("en-US", "gregory");
calendar.setTime(10540800000);
```
......@@ -824,7 +824,7 @@ set(year: number, month: number, date:number, hour?: number, minute?: number, se
**示例：**
```js
let 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
```
......@@ -845,7 +845,7 @@ setTimeZone(timezone: string): void
**示例：**
```js
let calendar = I18n.getCalendar("zh-Hans");
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.setTimeZone("Asia/Shanghai");
```
......@@ -866,9 +866,9 @@ getTimeZone(): string
**示例：**
```js
let calendar = I18n.getCalendar("zh-Hans");
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.setTimeZone("Asia/Shanghai");
let timezone = calendar.getTimeZone(); // timezone = "Asia/Shanghai"
let timezone: string = calendar.getTimeZone(); // timezone = "Asia/Shanghai"
```
......@@ -888,8 +888,8 @@ getFirstDayOfWeek(): number
**示例：**
```js
let calendar = I18n.getCalendar("en-US", "gregory");
let firstDayOfWeek = calendar.getFirstDayOfWeek(); // firstDayOfWeek = 1
let calendar: I18n.Calendar = I18n.getCalendar("en-US", "gregory");
let firstDayOfWeek: number = calendar.getFirstDayOfWeek(); // firstDayOfWeek = 1
```
......@@ -909,9 +909,9 @@ setFirstDayOfWeek(value: number): void
**示例：**
```js
let calendar = I18n.getCalendar("zh-Hans");
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.setFirstDayOfWeek(3);
let firstDayOfWeek = calendar.getFirstDayOfWeek(); // firstDayOfWeek = 3
let firstDayOfWeek: number = calendar.getFirstDayOfWeek(); // firstDayOfWeek = 3
```
......@@ -931,8 +931,8 @@ getMinimalDaysInFirstWeek(): number
**示例：**
```js
let calendar = I18n.getCalendar("zh-Hans");
let minimalDaysInFirstWeek = calendar.getMinimalDaysInFirstWeek(); // minimalDaysInFirstWeek = 1
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
let minimalDaysInFirstWeek: number = calendar.getMinimalDaysInFirstWeek(); // minimalDaysInFirstWeek = 1
```
......@@ -952,9 +952,9 @@ setMinimalDaysInFirstWeek(value: number): void
**示例：**
```js
let calendar = I18n.getCalendar("zh-Hans");
let calendar: I18n.Calendar = I18n.getCalendar("zh-Hans");
calendar.setMinimalDaysInFirstWeek(3);
let minimalDaysInFirstWeek = calendar.getMinimalDaysInFirstWeek(); // minimalDaysInFirstWeek = 3
let minimalDaysInFirstWeek: number = calendar.getMinimalDaysInFirstWeek(); // minimalDaysInFirstWeek = 3
```
......@@ -980,9 +980,9 @@ get(field: string): number
**示例：**
```js
let 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
let hourOfDay = calendar.get("hour_of_day"); // hourOfDay = 8
let hourOfDay: number = calendar.get("hour_of_day"); // hourOfDay = 8
```
......@@ -1008,8 +1008,8 @@ getDisplayName(locale: string): string
**示例：**
```js
let calendar = I18n.getCalendar("en-US", "buddhist");
let calendarName = calendar.getDisplayName("zh"); // calendarName = "佛历"
let calendar: I18n.Calendar = I18n.getCalendar("en-US", "buddhist");
let calendarName: string = calendar.getDisplayName("zh"); // calendarName = "佛历"
```
......@@ -1035,10 +1035,10 @@ isWeekend(date?: Date): boolean
**示例：**
```js
let 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.isWeekend(); // false
let date = new Date(2011, 11, 6, 9, 0, 0);
let date: Date = new Date(2011, 11, 6, 9, 0, 0);
calendar.isWeekend(date); // true
```
......@@ -1063,7 +1063,8 @@ constructor(country: string, options?: PhoneNumberFormatOptions)
**示例：**
```js
let phoneNumberFormat= new I18n.PhoneNumberFormat("CN", {"type": "E164"});
let option: I18n.PhoneNumberFormatOptions = {type: "E164"};
let phoneNumberFormat: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN", option);
```
......@@ -1089,8 +1090,8 @@ isValidNumber(number: string): boolean
**示例：**
```js
let phonenumberfmt = new I18n.PhoneNumberFormat("CN");
let isValidNumber = phonenumberfmt.isValidNumber("15812312312"); // isValidNumber = true
let phonenumberfmt: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN");
let isValidNumber: boolean = phonenumberfmt.isValidNumber("15812312312"); // isValidNumber = true
```
......@@ -1116,8 +1117,8 @@ format(number: string): string
**示例：**
```js
let phonenumberfmt = new I18n.PhoneNumberFormat("CN");
let formattedPhoneNumber = phonenumberfmt.format("15812312312"); // formattedPhoneNumber = "158 1231 2312"
let phonenumberfmt: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN");
let formattedPhoneNumber: string = phonenumberfmt.format("15812312312"); // formattedPhoneNumber = "158 1231 2312"
```
......@@ -1144,8 +1145,8 @@ getLocationName(number: string, locale: string): string
**示例：**
```js
let phonenumberfmt = new I18n.PhoneNumberFormat("CN");
let locationName = phonenumberfmt.getLocationName("15812312345", "zh-CN"); // locationName = "广东省湛江市"
let phonenumberfmt: I18n.PhoneNumberFormat = new I18n.PhoneNumberFormat("CN");
let locationName: string = phonenumberfmt.getLocationName("15812312345", "zh-CN"); // locationName = "广东省湛江市"
```
......@@ -1194,7 +1195,7 @@ getInstance(locale?:string): IndexUtil
**示例：**
```js
let indexUtil = I18n.getInstance("zh-CN");
let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN");
```
......@@ -1217,10 +1218,10 @@ getIndexList(): Array&lt;string&gt;
**示例：**
```js
let 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",
// "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z", "..." ]
let indexList = indexUtil.getIndexList();
let indexList: Array<string> = indexUtil.getIndexList();
```
......@@ -1240,7 +1241,7 @@ addLocale(locale: string): void
**示例：**
```js
let indexUtil = I18n.getInstance("zh-CN");
let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN");
indexUtil.addLocale("en-US");
```
......@@ -1267,8 +1268,8 @@ getIndex(text: string): string
**示例：**
```js
let indexUtil = I18n.getInstance("zh-CN");
let index = indexUtil.getIndex("hi"); // index = "H"
let indexUtil: I18n.IndexUtil = I18n.getInstance("zh-CN");
let index: string = indexUtil.getIndex("hi"); // index = "H"
```
......@@ -1294,7 +1295,7 @@ getLineInstance(locale: string): BreakIterator
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
```
......@@ -1317,7 +1318,7 @@ setLineBreakText(text: string): void
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit."); // 设置短句文本
```
......@@ -1338,9 +1339,9 @@ getLineBreakText(): string
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
let breakText = iterator.getLineBreakText(); // breakText = "Apple is my favorite fruit."
let breakText: string = iterator.getLineBreakText(); // breakText = "Apple is my favorite fruit."
```
......@@ -1360,9 +1361,9 @@ current(): number
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
let currentPos = iterator.current(); // currentPos = 0
let currentPos: number = iterator.current(); // currentPos = 0
```
......@@ -1382,9 +1383,9 @@ first(): number
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
let firstPos = iterator.first(); // firstPos = 0
let firstPos: number = iterator.first(); // firstPos = 0
```
......@@ -1404,9 +1405,9 @@ last(): number
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
let lastPos = iterator.last(); // lastPos = 27
let lastPos: number = iterator.last(); // lastPos = 27
```
......@@ -1432,9 +1433,9 @@ next(index?: number): number
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
let pos = iterator.first(); // pos = 0
let pos: number = iterator.first(); // pos = 0
pos = iterator.next(); // pos = 6
pos = iterator.next(10); // pos = -1
```
......@@ -1456,9 +1457,9 @@ previous(): number
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
let pos = iterator.first(); // pos = 0
let pos: number = iterator.first(); // pos = 0
pos = iterator.next(3); // pos = 12
pos = iterator.previous(); // pos = 9
```
......@@ -1486,9 +1487,9 @@ following(offset: number): number
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
let pos = iterator.following(0); // pos = 6
let pos: number = iterator.following(0); // pos = 6
pos = iterator.following(100); // pos = -1
pos = iterator.current(); // pos = 27
```
......@@ -1516,9 +1517,9 @@ isBoundary(offset: number): boolean
**示例：**
```js
let iterator = I18n.getLineInstance("en");
let iterator: I18n.BreakIterator = I18n.getLineInstance("en");
iterator.setLineBreakText("Apple is my favorite fruit.");
let isBoundary = iterator.isBoundary(0); // isBoundary = true;
let isBoundary: boolean = iterator.isBoundary(0); // isBoundary = true;
isBoundary = iterator.isBoundary(5); // isBoundary = false;
```
......@@ -1545,7 +1546,7 @@ getTimeZone(zoneID?: string): TimeZone
**示例：**
```js
let timezone = I18n.getTimeZone();
let timezone: I18n.TimeZone = I18n.getTimeZone();
```
......@@ -1568,8 +1569,8 @@ getID(): string
**示例：**
```js
let timezone = I18n.getTimeZone();
let timezoneID = timezone.getID(); // timezoneID = "Asia/Shanghai"
let timezone: I18n.TimeZone = I18n.getTimeZone();
let timezoneID: string = timezone.getID(); // timezoneID = "Asia/Shanghai"
```
......@@ -1596,8 +1597,8 @@ getDisplayName(locale?: string, isDST?: boolean): string
**示例：**
```js
let timezone = I18n.getTimeZone();
let timezoneName = timezone.getDisplayName("zh-CN", false); // timezoneName = "中国标准时间"
let timezone: I18n.TimeZone = I18n.getTimeZone();
let timezoneName: string = timezone.getDisplayName("zh-CN", false); // timezoneName = "中国标准时间"
```
......@@ -1617,8 +1618,8 @@ getRawOffset(): number
**示例：**
```js
let timezone = I18n.getTimeZone();
let offset = timezone.getRawOffset(); // offset = 28800000
let timezone: I18n.TimeZone = I18n.getTimeZone();
let offset: number = timezone.getRawOffset(); // offset = 28800000
```
......@@ -1638,8 +1639,8 @@ getOffset(date?: number): number
**示例：**
```js
let timezone = I18n.getTimeZone();
let offset = timezone.getOffset(1234567890); // offset = 28800000
let timezone: I18n.TimeZone = I18n.getTimeZone();
let offset: number = timezone.getOffset(1234567890); // offset = 28800000
```
......@@ -1660,7 +1661,7 @@ static getAvailableIDs(): Array&lt;string&gt;
**示例：**
```ts
// ids = ["America/Adak", "America/Anchorage", "America/Bogota", "America/Denver", "America/Los_Angeles", "America/Montevideo", "America/Santiago", "America/Sao_Paulo", "Asia/Ashgabat", "Asia/Hovd", "Asia/Jerusalem", "Asia/Magadan", "Asia/Omsk", "Asia/Shanghai", "Asia/Tokyo", "Asia/Yerevan", "Atlantic/Cape_Verde", "Australia/Lord_Howe", "Europe/Dublin", "Europe/London", "Europe/Moscow", "Pacific/Auckland", "Pacific/Easter", "Pacific/Pago-Pago"], 当前共支持24个时区
let ids = I18n.TimeZone.getAvailableIDs();
let ids: Array<string> = I18n.TimeZone.getAvailableIDs();
```
......@@ -1681,7 +1682,7 @@ static getAvailableZoneCityIDs(): Array&lt;string&gt;
**示例：**
```ts
// cityIDs = ["Auckland", "Magadan", "Lord Howe Island", "Tokyo", "Shanghai", "Hovd", "Omsk", "Ashgabat", "Yerevan", "Moscow", "Tel Aviv", "Dublin", "London", "Praia", "Montevideo", "Brasília", "Santiago", "Bogotá", "Easter Island", "Salt Lake City", "Los Angeles", "Anchorage", "Adak", "Pago Pago"]，当前共支持24个时区城市
let cityIDs = I18n.TimeZone.getAvailableZoneCityIDs();
let cityIDs: Array<string> = I18n.TimeZone.getAvailableZoneCityIDs();
```
......@@ -1708,7 +1709,7 @@ static getCityDisplayName(cityID: string, locale: string): string
**示例：**
```ts
let displayName = I18n.TimeZone.getCityDisplayName("Shanghai", "zh-CN"); // displayName = "上海(中国)"
let displayName: string = I18n.TimeZone.getCityDisplayName("Shanghai", "zh-CN"); // displayName = "上海(中国)"
```
......@@ -1734,7 +1735,7 @@ static getTimezoneFromCity(cityID: string): TimeZone
**示例：**
```ts
let timezone = I18n.TimeZone.getTimezoneFromCity("Shanghai");
let timezone: I18n.TimeZone = I18n.TimeZone.getTimezoneFromCity("Shanghai");
```
### getTimezonesByLocation<sup>10+</sup>
......@@ -1760,9 +1761,9 @@ static getTimezonesByLocation(longitude: number, latitude: number): Array&lt;Tim
**示例：**
```js
let timezoneArray = I18n.TimeZone.getTimezonesByLocation(-118.1, 34.0);
for (var i = 0; i < timezoneArray.length; i++) {
let tzId = timezoneArray[i].getID();
let timezoneArray: Array<I18n.TimeZone> = I18n.TimeZone.getTimezonesByLocation(-118.1, 34.0);
for (let i = 0; i < timezoneArray.length; i++) {
let tzId: string = timezoneArray[i].getID();
}
```
......@@ -1788,7 +1789,7 @@ static getAvailableIDs(): string[]
```ts
// ids共支持671个。每一个id由使用中划线分割的两部分组成，格式为 source-destination。例如ids = ["Han-Latin","Latin-ASCII", "Amharic-Latin/BGN","Accents-Any", ...]，Han-Latin表示汉语转为译拉丁文，Amharic-Latin表示阿姆哈拉语转为拉丁文。
// 更多使用信息可以参考ISO-15924。
let ids = I18n.Transliterator.getAvailableIDs();
let ids: string[] = I18n.Transliterator.getAvailableIDs();
```
......@@ -1814,7 +1815,7 @@ static getInstance(id: string): Transliterator
**示例：**
```ts
let transliterator = I18n.Transliterator.getInstance("Any-Latn");
let transliterator: I18n.Transliterator = I18n.Transliterator.getInstance("Any-Latn");
```
......@@ -1840,8 +1841,8 @@ transform(text: string): string
**示例：**
```ts
let transliterator = I18n.Transliterator.getInstance("Any-Latn");
let res = transliterator.transform("中国"); // res = "zhōng guó"
let transliterator: I18n.Transliterator = I18n.Transliterator.getInstance("Any-Latn");
let res: string = transliterator.transform("中国"); // res = "zhōng guó"
```
......@@ -1870,7 +1871,7 @@ static isDigit(char: string): boolean
**示例：**
```js
let isdigit = I18n.Unicode.isDigit("1"); // isdigit = true
let isdigit: boolean = I18n.Unicode.isDigit("1"); // isdigit = true
```
......@@ -1896,7 +1897,7 @@ static isSpaceChar(char: string): boolean
**示例：**
```js
let isspacechar = I18n.Unicode.isSpaceChar("a"); // isspacechar = false
let isspacechar: boolean = I18n.Unicode.isSpaceChar("a"); // isspacechar = false
```
......@@ -1922,7 +1923,7 @@ static isWhitespace(char: string): boolean
**示例：**
```js
let iswhitespace = I18n.Unicode.isWhitespace("a"); // iswhitespace = false
let iswhitespace: boolean = I18n.Unicode.isWhitespace("a"); // iswhitespace = false
```
......@@ -1948,7 +1949,7 @@ static isRTL(char: string): boolean
**示例：**
```js
let isrtl = I18n.Unicode.isRTL("a"); // isrtl = false
let isrtl: boolean = I18n.Unicode.isRTL("a"); // isrtl = false
```
......@@ -1974,7 +1975,7 @@ static isIdeograph(char: string): boolean
**示例：**
```js
let isideograph = I18n.Unicode.isIdeograph("a"); // isideograph = false
let isideograph: boolean = I18n.Unicode.isIdeograph("a"); // isideograph = false
```
......@@ -2000,7 +2001,7 @@ static isLetter(char: string): boolean
**示例：**
```js
let isletter = I18n.Unicode.isLetter("a"); // isletter = true
let isletter: boolean = I18n.Unicode.isLetter("a"); // isletter = true
```
......@@ -2026,7 +2027,7 @@ static isLowerCase(char: string): boolean
**示例：**
```js
let islowercase = I18n.Unicode.isLowerCase("a"); // islowercase = true
let islowercase: boolean = I18n.Unicode.isLowerCase("a"); // islowercase = true
```
......@@ -2052,7 +2053,7 @@ static isUpperCase(char: string): boolean
**示例：**
```js
let isuppercase = I18n.Unicode.isUpperCase("a"); // isuppercase = false
let isuppercase: boolean = I18n.Unicode.isUpperCase("a"); // isuppercase = false
```
......@@ -2114,7 +2115,7 @@ static getType(char: string): string
**示例：**
```js
let type = I18n.Unicode.getType("a"); // type = "U_LOWERCASE_LETTER"
let type: string = I18n.Unicode.getType("a"); // type = "U_LOWERCASE_LETTER"
```
## I18NUtil<sup>9+</sup>
......@@ -2146,7 +2147,7 @@ static unitConvert(fromUnit: UnitInfo, toUnit: UnitInfo, value: number, locale:
**示例：**
```js
let res = I18n.I18NUtil.unitConvert({unit: "cup", measureSystem: "US"}, {unit: "liter", measureSystem: "SI"}, 1000, "en-US", "long"); // res = 236.588 liters
let res: string = I18n.I18NUtil.unitConvert({unit: "cup", measureSystem: "US"}, {unit: "liter", measureSystem: "SI"}, 1000, "en-US", "long"); // res = 236.588 liters
```
......@@ -2172,7 +2173,7 @@ static getDateOrder(locale: string): string
**示例：**
```js
let order = I18n.I18NUtil.getDateOrder("zh-CN"); // order = "y-L-d"
let order: string = I18n.I18NUtil.getDateOrder("zh-CN"); // order = "y-L-d"
```
......@@ -2200,7 +2201,7 @@ static getInstance(mode: NormalizerMode): Normalizer
**示例：**
```js
let normalizer = I18n.Normalizer.getInstance(I18n.NormalizerMode.NFC);
let normalizer: I18n.Normalizer = I18n.Normalizer.getInstance(I18n.NormalizerMode.NFC);
```
......@@ -2226,8 +2227,8 @@ normalize(text: string): string
**示例：**
```js
let normalizer = I18n.Normalizer.getInstance(I18n.NormalizerMode.NFC);
let normalizedText = normalizer.normalize('\u1E9B\u0323'); // normalizedText = \u1E9B\u0323
let normalizer: I18n.Normalizer = I18n.Normalizer.getInstance(I18n.NormalizerMode.NFC);
let normalizedText: string = normalizer.normalize('\u1E9B\u0323'); // normalizedText = \u1E9B\u0323
```
......@@ -2260,7 +2261,7 @@ constructor()
**示例：**
```js
let systemLocaleManager= new I18n.SystemLocaleManager();
let systemLocaleManager: I18n.SystemLocaleManager = new I18n.SystemLocaleManager();
```
......@@ -2298,12 +2299,12 @@ getLanguageInfoArray(languages: Array&lt;string&gt;, options?: SortOptions): Arr
**示例：**
```js
// 当系统语言为zh-Hans，系统地区为CN，系统Locale为zh-Hans-CN时
let systemLocaleManager = new I18n.SystemLocaleManager();
var languages = ["zh-Hans", "en-US", "pt", "ar"];
var sortOptions = {locale: "zh-Hans-CN", isUseLocalName: true, isSuggestedFirst: true};
let systemLocaleManager: I18n.SystemLocaleManager = new I18n.SystemLocaleManager();
let languages: string[] = ["zh-Hans", "en-US", "pt", "ar"];
let sortOptions: I18n.SortOptions = {locale: "zh-Hans-CN", isUseLocalName: true, isSuggestedFirst: true};
try {
// 排序后的语言顺序为: [zh-Hans, en-US, pt, ar]
let sortedLanguages = systemLocaleManager.getLanguageInfoArray(languages, sortOptions);
let sortedLanguages: Array<I18n.LocaleItem> = systemLocaleManager.getLanguageInfoArray(languages, sortOptions);
} catch(error) {
console.error(`call systemLocaleManager.getLanguageInfoArray failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -2344,12 +2345,12 @@ getRegionInfoArray(regions: Array&lt;string&gt;, options?: SortOptions): Array&l
**示例：**
```js
// 当系统语言为zh-Hans，系统地区为CN，系统Locale为zh-Hans-CN时
let systemLocaleManager = new I18n.SystemLocaleManager();
var regions = ["CN", "US", "PT", "EG"];
var sortOptions = {locale: "zh-Hans-CN", isUseLocalName: false, isSuggestedFirst: true};
let systemLocaleManager: I18n.SystemLocaleManager = new I18n.SystemLocaleManager();
let regions: string[] = ["CN", "US", "PT", "EG"];
let sortOptions: I18n.SortOptions = {locale: "zh-Hans-CN", isUseLocalName: false, isSuggestedFirst: true};
try {
// 排序后的地区顺序为: [CN, EG, US, PT]
let sortedRegions = systemLocaleManager.getRegionInfoArray(regions, sortOptions);
let sortedRegions: Array<I18n.LocaleItem> = systemLocaleManager.getRegionInfoArray(regions, sortOptions);
} catch(error) {
console.error(`call systemLocaleManager.getRegionInfoArray failed, error code: ${error.code}, message: ${error.message}.`);
}
......@@ -2374,8 +2375,8 @@ static getTimeZoneCityItemArray(): Array&lt;TimeZoneCityItem&gt;
**示例：**
```js
try {
let timeZoneCityItemArray = I18n.SystemLocaleManager.getTimeZoneCityItemArray();
for (var i = 0; i < timeZoneCityItemArray.length; i++) {
let timeZoneCityItemArray: Array<I18n.TimeZoneCityItem> = I18n.SystemLocaleManager.getTimeZoneCityItemArray();
for (let i = 0; i < timeZoneCityItemArray.length; i++) {
console.log(timeZoneCityItemArray[i].zoneId + ", " + timeZoneCityItemArray[i].cityId + ", " + timeZoneCityItemArray[i].cityDisplayName +
", " + timeZoneCityItemArray[i].offset + "\r\n");
}
......@@ -2473,7 +2474,7 @@ getDisplayCountry(country: string, locale: string, sentenceCase?: boolean): stri
**示例：**
```js
let countryName = 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
```
......@@ -2504,7 +2505,7 @@ getDisplayLanguage(language: string, locale: string, sentenceCase?: boolean): st
**示例：**
```js
let languageName = 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"
```
......@@ -2527,7 +2528,7 @@ getSystemLanguage(): string
**示例：**
```js
let systemLanguage = I18n.getSystemLanguage(); // 返回当前系统语言
let systemLanguage: string = I18n.getSystemLanguage(); // 返回当前系统语言
```
......@@ -2549,7 +2550,7 @@ getSystemRegion(): string
**示例：**
```js
let region = I18n.getSystemRegion(); // 返回当前系统地区
let region: string = I18n.getSystemRegion(); // 返回当前系统地区
```
......@@ -2571,7 +2572,7 @@ getSystemLocale(): string
**示例：**
```js
let locale = I18n.getSystemLocale(); // 返回系统Locale
let locale: string = I18n.getSystemLocale(); // 返回系统Locale
```
......@@ -2593,7 +2594,7 @@ is24HourClock(): boolean
**示例：**
```js
let is24HourClock = I18n.is24HourClock();
let is24HourClock: boolean = I18n.is24HourClock();
```
......@@ -2624,7 +2625,7 @@ set24HourClock(option: boolean): boolean
**示例：**
```js
// 将系统时间设置为24小时制
let success = I18n.set24HourClock(true);
let success: boolean = I18n.set24HourClock(true);
```
......@@ -2656,9 +2657,9 @@ addPreferredLanguage(language: string, index?: number): boolean
**示例：**
```js
// 将语言zh-CN添加到系统偏好语言列表中
let language = 'zh-CN';
let index = 0;
let success = I18n.addPreferredLanguage(language, index);
let language: string = 'zh-CN';
let index: number = 0;
let success: boolean = I18n.addPreferredLanguage(language, index);
```
......@@ -2689,8 +2690,8 @@ removePreferredLanguage(index: number): boolean
**示例：**
```js
// 删除系统偏好语言列表中的第一个偏好语言
let index = 0;
let success = I18n.removePreferredLanguage(index);
let index: number = 0;
let success: boolean = I18n.removePreferredLanguage(index);
```
......@@ -2712,7 +2713,7 @@ getPreferredLanguageList(): Array&lt;string&gt;
**示例：**
```js
let preferredLanguageList = I18n.getPreferredLanguageList(); // 获取系统偏好语言列表
let preferredLanguageList: Array<string> = I18n.getPreferredLanguageList(); // 获取系统偏好语言列表
```
......@@ -2734,7 +2735,7 @@ getFirstPreferredLanguage(): string
**示例：**
```js
let firstPreferredLanguage = I18n.getFirstPreferredLanguage();
let firstPreferredLanguage: string = I18n.getFirstPreferredLanguage();
```
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或