Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
421d7ca3
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
421d7ca3
编写于
2月 15, 2023
作者:
O
openharmony_ci
提交者:
Gitee
2月 15, 2023
浏览文件
操作
浏览文件
下载
差异文件
!14685 更新i18n和intl文档
Merge pull request !14685 from sunyaozu/cherry-pick-1676368788
上级
964b7ef0
a17b2af4
变更
4
隐藏空白更改
内联
并排
Showing
4 changed file
with
71 addition
and
71 deletion
+71
-71
zh-cn/application-dev/internationalization/i18n-guidelines.md
...n/application-dev/internationalization/i18n-guidelines.md
+29
-29
zh-cn/application-dev/internationalization/intl-guidelines.md
...n/application-dev/internationalization/intl-guidelines.md
+13
-13
zh-cn/application-dev/reference/apis/js-apis-i18n.md
zh-cn/application-dev/reference/apis/js-apis-i18n.md
+23
-23
zh-cn/application-dev/reference/apis/js-apis-intl.md
zh-cn/application-dev/reference/apis/js-apis-intl.md
+6
-6
未找到文件。
zh-cn/application-dev/internationalization/i18n-guidelines.md
浏览文件 @
421d7ca3
...
...
@@ -6,7 +6,7 @@
## 获取和设置系统国际化相关信息
调用接口访问和设置系统语言、偏好语言、地区、24小时制、本地数字
开关
等国际化信息。
调用接口访问和设置系统语言、偏好语言、地区、24小时制、本地数字等国际化信息。
### 接口说明
...
...
@@ -30,15 +30,15 @@
| System | getPreferredLanguageList()
<sup>
9+
</sup>
| 获取系统偏好语言列表。 |
| System | getFirstPreferredLanguage()
<sup>
9+
</sup>
| 获取系统偏好语言列表中的第一个偏好语言。 |
| System | getAppPreferredLanguage()
<sup>
9+
</sup>
| 获取应用偏好语言。 |
| System | setUsingLocalDigit(flag: boolean)
<sup>
9+
</sup>
| 设置
是否打开本地数字开关
。 |
| System | getUsingLocalDigit()
<sup>
9+
</sup>
|
获取系统当前是否打开本地数字开关
。 |
| System | setUsingLocalDigit(flag: boolean)
<sup>
9+
</sup>
| 设置
系统是否使用本地数字
。 |
| System | getUsingLocalDigit()
<sup>
9+
</sup>
|
判断系统是否使用本地数字
。 |
| | isRTL(locale:string):boolean
<sup>
9+
</sup>
| locale对应的语言是否为从右到左语言。 |
### 开发步骤
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
获取和设置系统语言。
...
...
@@ -51,7 +51,7 @@
I18n
.
System
.
setSystemLanguage
(
"
en
"
);
// 将系统语言设置为 "en"
let
language
=
I18n
.
System
.
getSystemLanguage
();
// language = "en"
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -65,7 +65,7 @@
I18n
.
System
.
setSystemRegion
(
"
CN
"
);
// 将系统国家设置为 "CN"
let
region
=
I18n
.
System
.
getSystemRegion
();
// region = "CN"
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -79,7 +79,7 @@
I18n
.
System
.
setSystemLocale
(
"
zh-Hans-CN
"
);
// 将系统Locale设置为 "zh-Hans-CN"
let
locale
=
I18n
.
System
.
getSystemLocale
();
// locale = "zh-Hans-CN"
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -92,7 +92,7 @@
let
rtl
=
I18n
.
isRTL
(
"
zh-CN
"
);
// rtl = false
rtl
=
I18n
.
isRTL
(
"
ar
"
);
// rtl = true
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -106,7 +106,7 @@
I18n
.
System
.
set24HourClock
(
true
);
let
hourClock
=
I18n
.
System
.
is24HourClock
();
// hourClock = true
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -121,7 +121,7 @@
let
sentenceCase
=
false
;
let
localizedLanguage
=
I18n
.
System
.
getDisplayLanguage
(
language
,
locale
,
sentenceCase
);
// localizedLanguage = "英语"
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -136,7 +136,7 @@
let
sentenceCase
=
false
;
let
localizedCountry
=
I18n
.
System
.
getDisplayCountry
(
country
,
locale
,
sentenceCase
);
// localizedCountry = "美国"
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -150,7 +150,7 @@
let
languageList
=
I18n
.
System
.
getSystemLanguages
();
// languageList = ["en-Latn-US", "zh-Hans"]
let
countryList
=
I18n
.
System
.
getSystemCountries
(
"
zh
"
);
// countryList = ["ZW", "YT", ..., "CN", "DE"], 共240个国家和地区
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -162,7 +162,7 @@
try
{
let
isSuggest
=
I18n
.
System
.
isSuggested
(
"
zh
"
,
"
CN
"
);
// isSuggest = true
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -182,7 +182,7 @@
let
firstPreferredLanguage
=
I18n
.
System
.
getFirstPreferredLanguage
();
// firstPreferredLanguage = "en-GB"
let
appPreferredLanguage
=
I18n
.
System
.
getAppPreferredLanguage
();
// 当应用中包含 "en-GB"资源时,应用偏好语言为"en-GB"
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -190,14 +190,14 @@
调用setUsingLocalDigit接口打开本地化数字开关。(此接口为系统接口,只有具有UPDATE_CONFIGURATION权限的系统应用可以调用。)
调用getUsingLocalDigit接口访问本地化数字开关状态。
当前只有 "ar", "as", "bn", "fa", "mr", "my", "ne", "ur" 8个语言支持
打开本地数字开关
。
当前只有 "ar", "as", "bn", "fa", "mr", "my", "ne", "ur" 8个语言支持
使用本地数字
。
```
js
try
{
I18n
.
System
.
setUsingLocalDigit
(
true
);
// 打开本地化数字开关
let
status
=
I18n
.
System
.
getUsingLocalDigit
();
// status = true
}
catch
(
error
)
{
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
console
.
error
(
`call i18n.System interface failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
`
)
;
}
```
...
...
@@ -220,14 +220,14 @@ try {
| Calendar | getMinimalDaysInFirstWeek():number
<sup>
8+
</sup>
| 获取一年中第一周的最小天数。 |
| Calendar | setMinimalDaysInFirstWeek(value:number): void
<sup>
8+
</sup>
| 设置一年中第一周的最小天数。 |
| Calendar | getDisplayName(locale:string):string
<sup>
8+
</sup>
| 获取日历对象的本地化表示。 |
| Calendar | isWeekend(date?:Date):boolean
<sup>
8+
</sup>
| 判断给定的日期
是否在日历中
是周末。 |
| Calendar | isWeekend(date?:Date):boolean
<sup>
8+
</sup>
| 判断给定的日期
在日历中是否
是周末。 |
### 开发步骤
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
实例化日历对象。
...
...
@@ -254,7 +254,7 @@ try {
调用set接口设置日历对象的年、月、日、时、分、秒。
```
js
calendar
.
set
(
2021
,
12
,
21
,
6
,
0
,
0
)
calendar
.
set
(
2021
,
12
,
21
,
6
,
0
,
0
)
;
```
5.
设置、获取日历对象的时区。
...
...
@@ -317,7 +317,7 @@ try {
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
实例化电话号码格式化对象。
...
...
@@ -359,7 +359,7 @@ try {
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
度量衡单位转换。
...
...
@@ -393,7 +393,7 @@ try {
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
实例化字母表索引对象。
...
...
@@ -418,7 +418,7 @@ try {
调用addLocale接口,将新的Locale对应的字母表索引添加到当前字母表索引列表中。
```
js
indexUtil
.
addLocale
(
"
ar
"
)
indexUtil
.
addLocale
(
"
ar
"
)
;
```
5.
获取字符串对应的索引。
...
...
@@ -454,7 +454,7 @@ try {
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
实例化断行对象。
...
...
@@ -462,7 +462,7 @@ try {
调用getLineInstance接口来实例化断行对象。
```
js
let
locale
=
"
en-US
"
let
locale
=
"
en-US
"
;
let
breakIterator
=
I18n
.
getLineInstance
(
locale
);
```
...
...
@@ -531,7 +531,7 @@ try {
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
实例化时区对象,并获取相关时区信息。
...
...
@@ -592,7 +592,7 @@ try {
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
获取支持音译的ID列表。
...
...
@@ -637,7 +637,7 @@ try {
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
判断字符是否具有某种性质。
...
...
@@ -719,7 +719,7 @@ try {
1.
导入I18n模块。
```
js
import
I18n
from
'
@ohos.i18n
'
import
I18n
from
'
@ohos.i18n
'
;
```
2.
判断日期的年月日的排序顺序。
...
...
zh-cn/application-dev/internationalization/intl-guidelines.md
浏览文件 @
421d7ca3
...
...
@@ -25,7 +25,7 @@
未正确导入包可能会产生不明确的接口行为。
```
js
import
Intl
from
'
@ohos.intl
'
import
Intl
from
'
@ohos.intl
'
;
```
2.
实例化Locale对象。
...
...
@@ -100,7 +100,7 @@
未正确导入包可能会产生不明确的接口行为。
```
js
import
Intl
from
'
@ohos.intl
'
import
Intl
from
'
@ohos.intl
'
;
```
2.
实例化日期时间格式化对象。
...
...
@@ -170,7 +170,7 @@
未正确导入包可能会产生不明确的接口行为。
```
js
import
Intl
from
'
@ohos.intl
'
import
Intl
from
'
@ohos.intl
'
;
```
2.
实例化数字格式化对象。
...
...
@@ -195,7 +195,7 @@
```
js
let
options
=
{
compactDisplay
:
"
short
"
,
notation
:
"
compact
"
};
let
numberFormat
=
new
Intl
.
NumberFormat
(
"
zh-CN
"
,
options
);
let
number
=
1234.5678
let
number
=
1234.5678
;
let
formatResult
=
numberFormat
.
format
(
number
);
// formatResult = "1235"
```
...
...
@@ -229,7 +229,7 @@
未正确导入包可能会产生不明确的接口行为。
```
js
import
Intl
from
'
@ohos.intl
'
import
Intl
from
'
@ohos.intl
'
;
```
2.
实例化排序对象。
...
...
@@ -240,7 +240,7 @@
let
collator
=
new
Intl
.
Collator
();
```
另一种方法是使用开发者提供的Locale和其他相关参数来创建Collator对象,完整的参数列表参见[CollatorOptions](../reference/apis/js-apis-intl.md#collatoroptions
9
)。
另一种方法是使用开发者提供的Locale和其他相关参数来创建Collator对象,完整的参数列表参见[CollatorOptions](../reference/apis/js-apis-intl.md#collatoroptions
8
)。
其中,sensitivity参数用于控制哪些级别的差异会被用于比较两个字符串。取值"base"表示,仅比较字符本身,不考虑重音符号、大小写差异。例如,'a' != 'b','a' == 'á','a' == 'A'。取值"accent"表示考虑重音符号,不考虑大小写的差异。例如,'a' != 'b','a' != 'á','a' == 'A'。取值"case"表示考虑大小写的差异,不考虑重音符号的差异。例如,'a' != 'b','a' == 'á','a' != 'A'。取值"variant"表示考虑重音符号、大小写等方面差异。例如'a' != 'b','a' != 'á','a' != 'A'。
```
js
...
...
@@ -290,7 +290,7 @@
未正确导入包可能会产生不明确的接口行为。
```
js
import
Intl
from
'
@ohos.intl
'
import
Intl
from
'
@ohos.intl
'
;
```
2.
实例化单复数对象。
...
...
@@ -301,7 +301,7 @@
let
pluralRules
=
new
Intl
.
PluralRules
();
```
另一种方法是使用开发者提供的Locale和其他相关参数来创建单复数对象。完整的参数列表参见[PluralRulesOptions](../reference/apis/js-apis-intl.md#pluralrulesoptions
9
)。
另一种方法是使用开发者提供的Locale和其他相关参数来创建单复数对象。完整的参数列表参见[PluralRulesOptions](../reference/apis/js-apis-intl.md#pluralrulesoptions
8
)。
```
js
let
pluralRules
=
new
Intl
.
PluralRules
(
"
zh-CN
"
,
{
localeMatcher
:
"
best fit
"
,
type
:
"
cardinal
"
});
...
...
@@ -313,7 +313,7 @@
```
js
let
pluralRules
=
new
Intl
.
PluralRules
(
"
zh-CN
"
,
{
localeMatcher
:
"
best fit
"
,
type
:
"
cardinal
"
});
let
number
=
1234.5678
let
number
=
1234.5678
;
let
categoryResult
=
pluralRules
.
select
(
number
);
// categoryResult = "other"
```
...
...
@@ -338,7 +338,7 @@
未正确导入包可能会产生不明确的接口行为。
```
js
import
Intl
from
'
@ohos.intl
'
import
Intl
from
'
@ohos.intl
'
;
```
2.
实例化相对时间格式化对象。
...
...
@@ -349,7 +349,7 @@
let
relativeTimeFormat
=
new
Intl
.
RelativeTimeFormat
();
```
另一种方法是使用开发者提供的Locale和格式化参数来创建相对时间格式化对象。其中,格式化参数是可选的,完整的参数列表参见[ RelativeTimeFormatInputOptions](../reference/apis/js-apis-intl.md#relativetimeformatinputoptions
9
)。
另一种方法是使用开发者提供的Locale和格式化参数来创建相对时间格式化对象。其中,格式化参数是可选的,完整的参数列表参见[ RelativeTimeFormatInputOptions](../reference/apis/js-apis-intl.md#relativetimeformatinputoptions
8
)。
```
js
let
relativeTimeFormat
=
new
Intl
.
RelativeTimeFormat
(
"
zh-CN
"
,
{
numeric
:
"
always
"
,
style
:
"
long
"
});
...
...
@@ -362,7 +362,7 @@
```
js
let
relativeTimeFormat
=
new
Intl
.
RelativeTimeFormat
(
"
zh-CN
"
,
{
numeric
:
"
always
"
,
style
:
"
long
"
});
let
number
=
2
;
let
unit
=
"
year
"
let
unit
=
"
year
"
;
let
formatResult
=
relativeTimeFormat
.
format
(
number
,
unit
);
// 2年后
```
...
...
@@ -373,7 +373,7 @@
```
js
let
relativeTimeFormat
=
new
Intl
.
RelativeTimeFormat
(
"
zh-CN
"
,
{
numeric
:
"
always
"
,
style
:
"
long
"
});
let
number
=
2
;
let
unit
=
"
year
"
let
unit
=
"
year
"
;
let
formatPartsResult
=
relativeTimeFormat
.
formatToParts
(
number
,
unit
);
// formatPartsResult = [{"type": "integer", "value": "2", "unit": "year"}, {"type":"literal", "value": "年后"}]
```
...
...
zh-cn/application-dev/reference/apis/js-apis-i18n.md
浏览文件 @
421d7ca3
...
...
@@ -53,7 +53,7 @@ static getDisplayCountry(country: string, locale: string, sentenceCase?: boolean
try
{
let
displayCountry
=
I18n
.
System
.
getDisplayCountry
(
"
zh-CN
"
,
"
en-GB
"
);
// displayCountry = "China"
}
catch
(
error
)
{
console
.
error
(
`call System.getDisplayCountry failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getDisplayCountry failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -92,7 +92,7 @@ static getDisplayLanguage(language: string, locale: string, sentenceCase?: boole
try
{
let
displayLanguage
=
I18n
.
System
.
getDisplayLanguage
(
"
zh
"
,
"
en-GB
"
);
// displayLanguage = Chinese
}
catch
(
error
)
{
console
.
error
(
`call System.getDisplayLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getDisplayLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -123,7 +123,7 @@ static getSystemLanguages(): Array<string>
try
{
let
systemLanguages
=
I18n
.
System
.
getSystemLanguages
();
// [ "en-Latn-US", "zh-Hans" ]
}
catch
(
error
)
{
console
.
error
(
`call System.getSystemLanguages failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getSystemLanguages failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -160,7 +160,7 @@ static getSystemCountries(language: string): Array<string>
try
{
let
systemCountries
=
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
}
.`
)
console
.
error
(
`call System.getSystemCountries failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -198,7 +198,7 @@ static isSuggested(language: string, region?: string): boolean
try
{
let
res
=
I18n
.
System
.
isSuggested
(
'
zh
'
,
'
CN
'
);
// res = true
}
catch
(
error
)
{
console
.
error
(
`call System.isSuggested failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.isSuggested failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -229,7 +229,7 @@ static getSystemLanguage(): string
try
{
let
systemLanguage
=
I18n
.
System
.
getSystemLanguage
();
// systemLanguage为当前系统语言
}
catch
(
error
)
{
console
.
error
(
`call System.getSystemLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getSystemLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -264,7 +264,7 @@ static setSystemLanguage(language: string): void
try
{
I18n
.
System
.
setSystemLanguage
(
'
zh
'
);
// 设置系统当前语言为 "zh"
}
catch
(
error
)
{
console
.
error
(
`call System.setSystemLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.setSystemLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -295,7 +295,7 @@ static getSystemRegion(): string
try
{
let
systemRegion
=
I18n
.
System
.
getSystemRegion
();
// 获取系统当前地区设置
}
catch
(
error
)
{
console
.
error
(
`call System.getSystemRegion failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getSystemRegion failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -330,7 +330,7 @@ static setSystemRegion(region: string): void
try
{
I18n
.
System
.
setSystemRegion
(
'
CN
'
);
// 设置系统当前地区为 "CN"
}
catch
(
error
)
{
console
.
error
(
`call System.setSystemRegion failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.setSystemRegion failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -361,7 +361,7 @@ static getSystemLocale(): string
try
{
let
systemLocale
=
I18n
.
System
.
getSystemLocale
();
// 获取系统当前Locale
}
catch
(
error
)
{
console
.
error
(
`call System.getSystemLocale failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getSystemLocale failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -396,7 +396,7 @@ static setSystemLocale(locale: string): void
try
{
I18n
.
System
.
setSystemLocale
(
'
zh-CN
'
);
// 设置系统当前Locale为 "zh-CN"
}
catch
(
error
)
{
console
.
error
(
`call System.setSystemLocale failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.setSystemLocale failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -427,7 +427,7 @@ static is24HourClock(): boolean
try
{
let
is24HourClock
=
I18n
.
System
.
is24HourClock
();
// 系统24小时开关是否开启
}
catch
(
error
)
{
console
.
error
(
`call System.is24HourClock failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.is24HourClock failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -463,7 +463,7 @@ static set24HourClock(option: boolean): void
try
{
I18n
.
System
.
set24HourClock
(
true
);
}
catch
(
error
)
{
console
.
error
(
`call System.set24HourClock failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.set24HourClock failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -502,7 +502,7 @@ static addPreferredLanguage(language: string, index?: number): void
try
{
I18n
.
System
.
addPreferredLanguage
(
language
,
index
);
// 将zh-CN添加到系统偏好语言列表的第1位
}
catch
(
error
)
{
console
.
error
(
`call System.addPreferredLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.addPreferredLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -539,7 +539,7 @@ static removePreferredLanguage(index: number): void
try
{
I18n
.
System
.
removePreferredLanguage
(
index
);
}
catch
(
error
)
{
console
.
error
(
`call System.removePreferredLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.removePreferredLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -570,7 +570,7 @@ static getPreferredLanguageList(): Array<string>
try
{
let
preferredLanguageList
=
I18n
.
System
.
getPreferredLanguageList
();
// 获取系统当前偏好语言列表
}
catch
(
error
)
{
console
.
error
(
`call System.getPreferredLanguageList failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getPreferredLanguageList failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -601,7 +601,7 @@ static getFirstPreferredLanguage(): string
try
{
let
firstPreferredLanguage
=
I18n
.
System
.
getFirstPreferredLanguage
();
// 获取系统当前偏好语言列表中的第一个偏好语言
}
catch
(
error
)
{
console
.
error
(
`call System.getFirstPreferredLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getFirstPreferredLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -632,7 +632,7 @@ static getAppPreferredLanguage(): string
try
{
let
appPreferredLanguage
=
I18n
.
System
.
getAppPreferredLanguage
();
// 获取应用偏好语言
}
catch
(
error
)
{
console
.
error
(
`call System.getAppPreferredLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getAppPreferredLanguage failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -640,7 +640,7 @@ static getAppPreferredLanguage(): string
static setUsingLocalDigit(flag: boolean): void
设置
是否打开本地数字开关
。
设置
系统是否使用本地数字
。
此接口为系统接口。
...
...
@@ -667,7 +667,7 @@ static setUsingLocalDigit(flag: boolean): void
try
{
I18n
.
System
.
setUsingLocalDigit
(
true
);
// 打开本地化数字开关
}
catch
(
error
)
{
console
.
error
(
`call System.setUsingLocalDigit failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.setUsingLocalDigit failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -675,7 +675,7 @@ static setUsingLocalDigit(flag: boolean): void
static getUsingLocalDigit(): boolean
获取系统当前是否打开本地数字开关
。
判断系统是否使用本地数字
。
**系统能力**
:SystemCapability.Global.I18n
...
...
@@ -698,7 +698,7 @@ static getUsingLocalDigit(): boolean
try
{
let
status
=
I18n
.
System
.
getUsingLocalDigit
();
// 判断本地化数字开关是否打开
}
catch
(
error
)
{
console
.
error
(
`call System.getUsingLocalDigit failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
console
.
error
(
`call System.getUsingLocalDigit failed, error code:
${
error
.
code
}
, message:
${
error
.
message
}
.`
)
;
}
```
...
...
@@ -1025,7 +1025,7 @@ isWeekend(date?: Date): boolean
| 参数名 | 类型 | 必填 | 说明 |
| ---- | ---- | ---- | ---------------------------------------- |
| date | Date | 否 | 判断日期在日历中是否是周末。如果
date没有给出,判断calendar
当前日期是否为周末。 |
| date | Date | 否 | 判断日期在日历中是否是周末。如果
不传日期参数,则判断
当前日期是否为周末。 |
**返回值:**
...
...
zh-cn/application-dev/reference/apis/js-apis-intl.md
浏览文件 @
421d7ca3
...
...
@@ -48,9 +48,9 @@ constructor()
**示例:**
```
js
// 默认构造函数使用系统当前locale创建Locale对象
let
locale
=
new
Intl
.
Locale
()
let
locale
=
new
Intl
.
Locale
()
;
// 返回系统当前localel
let
localeID
=
locale
.
toString
()
let
localeID
=
locale
.
toString
()
;
```
...
...
@@ -72,8 +72,8 @@ constructor(locale: string, options?: LocaleOptions)
**示例:**
```
js
// 创建 "zh-CN" Locale对象
let
locale
=
new
Intl
.
Locale
(
"
zh-CN
"
)
let
localeID
=
locale
.
toString
()
// localeID = "zh-CN"
let
locale
=
new
Intl
.
Locale
(
"
zh-CN
"
)
;
let
localeID
=
locale
.
toString
()
;
// localeID = "zh-CN"
```
...
...
@@ -429,7 +429,7 @@ resolvedOptions(): NumberOptions
// 获取NumberFormat对象配置项
let
options
=
numfmt
.
resolvedOptions
();
let
style
=
options
.
style
;
// style = decimal
let
notation
=
options
.
notation
// notation = scientific
let
notation
=
options
.
notation
;
// notation = scientific
```
...
...
@@ -552,7 +552,7 @@ resolvedOptions(): CollatorOptions
// 获取Collator对象的配置项
let
options
=
collator
.
resolvedOptions
();
let
usage
=
options
.
usage
;
// usage = "sort"
let
ignorePunctuation
=
options
.
ignorePunctuation
// ignorePunctuation = true
let
ignorePunctuation
=
options
.
ignorePunctuation
;
// ignorePunctuation = true
```
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录