Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
dbdb2674
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
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看板
未验证
提交
dbdb2674
编写于
11月 11, 2022
作者:
葛
葛亚芳
提交者:
Gitee
11月 11, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/application-dev/reference/apis/js-apis-system-time.md.
Signed-off-by:
N
葛亚芳
<
geyafang@huawei.com
>
上级
c265a4ea
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
228 addition
and
245 deletion
+228
-245
zh-cn/application-dev/reference/apis/js-apis-system-time.md
zh-cn/application-dev/reference/apis/js-apis-system-time.md
+228
-245
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-system-time.md
浏览文件 @
dbdb2674
# 设置系统时间
# 设置系统时间
、时区
本模块用来设置、获取当前系统时间
,设置、获取当前系统日期和设置、获取当前
系统时区。
本模块用来设置、获取当前系统时间
、系统日期和
系统时区。
>  **说明:**
> **说明:**
>
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
## 导入模块
```
js
```
import
systemTime
from
'
@ohos.systemTime
'
;
import
systemTime
from
'
@ohos.systemTime
'
;
```
```
## systemTime.setTime
## systemTime.setTime
setTime(time : number, callback : AsyncCallback
<
void
>
) : void
setTime(time : number, callback : AsyncCallback
<
void
>
) : void
设置系统时间。
设置系统时间
,使用callback异步回调
。
**需要权限:**
ohos.permission.SET_TIME
**需要权限:**
ohos.permission.SET_TIME
...
@@ -26,31 +24,30 @@ setTime(time : number, callback : AsyncCallback<void>) : void
...
@@ -26,31 +24,30 @@ setTime(time : number, callback : AsyncCallback<void>) : void
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| time | number | 是 | 目标时间戳(ms)。 |
| time | number | 是 | 目标时间戳(ms)。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值
。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数
。 |
**示例:**
**示例:**
```
js
```
js
// time对应的时间为2021-01-20 02:36:25
// time对应的时间为2021-01-20 02:36:25
var
time
=
1611081385000
;
let
time
=
1611081385000
;
systemTime
.
setTime
(
time
,
(
error
,
data
)
=>
{
systemTime
.
setTime
(
time
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
error
(
`failed to systemTime.setTime because
`
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to set systemTime. Cause:
`
+
JSON
.
stringify
(
error
));
return
;
return
;
}
}
console
.
log
(
`systemTime.setTime success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
'
Succeeded in setting systemTime.
'
);
});
});
```
```
## systemTime.setTime
## systemTime.setTime
setTime(time : number) : Promise
<
void
>
setTime(time : number) : Promise
<
void
>
设置系统时间。
设置系统时间
,使用Promise异步回调
。
**需要权限:**
ohos.permission.SET_TIME
**需要权限:**
ohos.permission.SET_TIME
...
@@ -58,211 +55,204 @@ setTime(time : number) : Promise<void>
...
@@ -58,211 +55,204 @@ setTime(time : number) : Promise<void>
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| time | number | 是 | 目标时间戳(ms)。 |
| time | number | 是 | 目标时间戳(ms)。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
| Promise
<
void
>
| 返回的异步回调函数
。 |
| Promise
<
void
>
| 无返回结果的Promise对象
。 |
**示例:**
**示例:**
```
js
```
js
// time对应的时间为2021-01-20 02:36:25
// time对应的时间为2021-01-20 02:36:25
var
time
=
1611081385000
;
let
time
=
1611081385000
;
systemTime
.
setTime
(
time
).
then
((
data
)
=>
{
systemTime
.
setTime
(
time
).
then
(()
=>
{
console
.
log
(
`systemTime.setTime success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
'
Succeeded in setting systemTime.
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
error
(
`failed to systemTime.setTime because `
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to set systemTime. Cause:`
+
JSON
.
stringify
(
error
));
});
});
```
```
## systemTime.getCurrentTime<sup>8+</sup>
## systemTime.getCurrentTime<sup>8+</sup>
getCurrentTime(isNano?: boolean, callback: AsyncCallback
<
number
>
): void
getCurrentTime(isNano?: boolean, callback: AsyncCallback
<
number
>
): void
获取自
Unix 纪元以来经过的时间,使用callback形式返回结果
。
获取自
Unix纪元以来经过的时间,使用callback异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自
Unix
纪元以来经过的时间。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自Unix
纪元以来经过的时间。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getCurrentTime
(
true
,
(
error
,
data
)
=>
{
systemTime
.
getCurrentTime
(
true
,
(
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
error
(
`failed to systemTime.getCurrentTime because
`
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get systemTime. Cause:
`
+
JSON
.
stringify
(
error
));
return
;
return
;
}
}
console
.
log
(
`systemTime.getCurrentTime success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting systemTime.Data: `
+
JSON
.
stringify
(
data
));
});
});
```
```
## systemTime.getCurrentTime<sup>8+</sup>
## systemTime.getCurrentTime<sup>8+</sup>
getCurrentTime(isNano?: boolean): Promise
<
number
>
getCurrentTime(isNano?: boolean): Promise
<
number
>
获取自
Unix 纪元以来经过的时间,使用Promise形式返回结果
。
获取自
Unix纪元以来经过的时间,使用Promise异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
| Promise
<
number
>
| 以Promise形式返回结果,返回自
Unix
纪元以来经过的时间。 |
| Promise
<
number
>
| Promise对象,返回自Unix
纪元以来经过的时间。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getCurrentTime
().
then
((
data
)
=>
{
systemTime
.
getCurrentTime
().
then
((
data
)
=>
{
console
.
log
(
`systemTime.getCurrentTime success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting systemTime.Data: `
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
error
(
`failed to systemTime.getCurrentTime because `
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get systemTime. Cause:`
+
JSON
.
stringify
(
error
));
});
});
```
```
## systemTime.getRealActiveTime<sup>8+</sup>
## systemTime.getRealActiveTime<sup>8+</sup>
getRealActiveTime(isNano?: boolean, callback: AsyncCallback
<
number
>
): void
getRealActiveTime(isNano?: boolean, callback: AsyncCallback
<
number
>
): void
获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback
形式返回结果
。
获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback
异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getRealActiveTime
(
true
,
(
error
,
data
)
=>
{
systemTime
.
getRealActiveTime
(
true
,
(
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
error
(
`failed to systemTime.getRealActiveTimebecause
`
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get real active systemTime. Cause:
`
+
JSON
.
stringify
(
error
));
return
;
return
;
}
}
console
.
log
(
`systemTime.getRealActiveTime success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting real active systemTime. Data: `
+
JSON
.
stringify
(
data
));
});
});
```
```
## systemTime.getRealActiveTime<sup>8+</sup>
## systemTime.getRealActiveTime<sup>8+</sup>
getRealActiveTime(isNano?: boolean): Promise
<
number
>
getRealActiveTime(isNano?: boolean): Promise
<
number
>
获取自系统启动以来经过的时间,不包括深度睡眠时间,使用Promise
形式返回结果
。
获取自系统启动以来经过的时间,不包括深度睡眠时间,使用Promise
异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
| Promise
<
number
>
| 以Promise形式返回结果
,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 |
| Promise
<
number
>
| Promise对象
,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getRealActiveTime
().
then
((
data
)
=>
{
systemTime
.
getRealActiveTime
().
then
((
data
)
=>
{
console
.
log
(
`systemTime.getRealActiveTime success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting real active systemTime. Data: `
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
error
(
`failed to systemTime.getRealActiveTime because `
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get real active systemTime. Cause:`
+
JSON
.
stringify
(
error
));
});
});
```
```
## systemTime.getRealTime<sup>8+</sup>
## systemTime.getRealTime<sup>8+</sup>
getRealTime(isNano?: boolean, callback: AsyncCallback
<
number
>
): void
getRealTime(isNano?: boolean, callback: AsyncCallback
<
number
>
): void
获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback
形式返回结果
。
获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback
异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getRealTime
(
true
,
(
error
,
data
)
=>
{
systemTime
.
getRealTime
(
true
,
(
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
error
(
`failed to systemTime.getRealTime because
`
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get real systemTime. Cause:
`
+
JSON
.
stringify
(
error
));
return
;
return
;
}
}
console
.
log
(
`systemTime.getRealTime success data: `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting real active systemTime. Data: `
+
JSON
.
stringify
(
data
));
});
});
```
```
## systemTime.getRealTime<sup>8+</sup>
## systemTime.getRealTime<sup>8+</sup>
getRealTime(isNano?: boolean): Promise
<
number
>
getRealTime(isNano?: boolean): Promise
<
number
>
获取自系统启动以来经过的时间,包括深度睡眠时间,使用Promise
形式返回结果
。
获取自系统启动以来经过的时间,包括深度睡眠时间,使用Promise
异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
| Promise
<
number
>
| 以Promise形式返回结果
,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
| Promise
<
number
>
| Promise对象
,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getRealTime
().
then
((
data
)
=>
{
systemTime
.
getRealTime
().
then
((
data
)
=>
{
console
.
log
(
`systemTime.getRealTime success data: `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting real active systemTime. Data: `
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
error
(
`failed to systemTime.getRealTime because `
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get real systemTime. Cause:`
+
JSON
.
stringify
(
error
));
});
});
```
```
## systemTime.setDate
## systemTime.setDate
setDate(date: Date, callback: AsyncCallback
<
void
>
): void
setDate(date: Date, callback: AsyncCallback
<
void
>
): void
设置系统日期,使用callback
形式返回结果
。
设置系统日期,使用callback
异步回调
。
**需要权限:**
ohos.permission.SET_TIME
**需要权限:**
ohos.permission.SET_TIME
...
@@ -270,30 +260,29 @@ setDate(date: Date, callback: AsyncCallback<void>): void
...
@@ -270,30 +260,29 @@ setDate(date: Date, callback: AsyncCallback<void>): void
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| date | Date | 是 | 目标日期。 |
| date | Date | 是 | 目标日期。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值
。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数
。 |
**示例:**
**示例:**
```
js
```
js
var
data
=
new
Date
(
"
October 13, 2020 11:13:00
"
);
let
data
=
new
Date
(
"
October 13, 2020 11:13:00
"
);
systemTime
.
setDate
(
data
,(
error
,
data
)
=>
{
systemTime
.
setDate
(
data
,(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
error
(
'
failed to systemTime.setDate because
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
Failed to set systemDate. Cause:
'
+
JSON
.
stringify
(
error
));
return
;
return
;
}
}
console
.
info
(
'
systemTime.setDate success data :
'
+
JSON
.
stringify
(
data
));
console
.
info
(
'
Succeeded in setting systemDate.
'
);
});
});
```
```
## systemTime.setDate
## systemTime.setDate
setDate(date: Date): Promise
<
void
>
setDate(date: Date): Promise
<
void
>
设置系统日期,使用Promise
形式返回结果
。
设置系统日期,使用Promise
异步回调
。
**需要权限:**
ohos.permission.SET_TIME
**需要权限:**
ohos.permission.SET_TIME
...
@@ -301,85 +290,82 @@ setDate(date: Date): Promise<void>
...
@@ -301,85 +290,82 @@ setDate(date: Date): Promise<void>
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| date | Date | 是 | 目标日期。 |
| date | Date | 是 | 目标日期。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
| Promise
<
void
>
| 返回的异步回调函数
。 |
| Promise
<
void
>
| 无返回结果的Promise对象
。 |
**示例:**
**示例:**
```
js
```
js
var
data
=
new
Date
(
"
October 13, 2020 11:13:00
"
);
let
data
=
new
Date
(
"
October 13, 2020 11:13:00
"
);
systemTime
.
setDate
(
data
).
then
((
value
)
=>
{
systemTime
.
setDate
(
data
).
then
(()
=>
{
console
.
log
(
`systemTime.setDate success data : `
+
JSON
.
stringify
(
value
));
console
.
log
(
'
Succeeded in setting systemDate.
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
error
(
`failed to systemTime.setDate because: `
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to set systemDate. Cause: `
+
JSON
.
stringify
(
error
));
});
});
```
```
## systemTime.getDate<sup>8+</sup>
## systemTime.getDate<sup>8+</sup>
getDate(callback: AsyncCallback
<
Date
>
): void
getDate(callback: AsyncCallback
<
Date
>
): void
获取当前系统日期,使用callback
形式返回结果
。
获取当前系统日期,使用callback
异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
Date
>
| 是 | 回调函数,返回当前系统日期。 |
| callback | AsyncCallback
<
Date
>
| 是 | 回调函数,返回当前系统日期。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getDate
((
error
,
data
)
=>
{
systemTime
.
getDate
((
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
error
(
`failed to systemTime.getDate because
`
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get systemDate. Cause:
`
+
JSON
.
stringify
(
error
));
return
;
return
;
}
}
console
.
log
(
`systemTime.getDate success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting systemDate. Data: `
+
JSON
.
stringify
(
data
));
});
});
```
```
## systemTime.getDate<sup>8+</sup>
## systemTime.getDate<sup>8+</sup>
getDate(): Promise
<
Date
>
getDate(): Promise
<
Date
>
获取当前系统日期,使用Promise
形式返回结果
。
获取当前系统日期,使用Promise
异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
| Promise
<
Date
>
| 以Promise形式返回结果
,返回当前系统日期。 |
| Promise
<
Date
>
| Promise对象
,返回当前系统日期。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getDate
().
then
((
data
)
=>
{
systemTime
.
getDate
().
then
((
data
)
=>
{
console
.
log
(
`systemTime.getDate success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting systemDate. Data: `
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
error
(
`failed to systemTime.getDate because `
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get systemDate. Cause: `
+
JSON
.
stringify
(
error
));
});
});
```
```
## systemTime.setTimezone
## systemTime.setTimezone
setTimezone(timezone: string, callback: AsyncCallback
<
void
>
): void
setTimezone(timezone: string, callback: AsyncCallback
<
void
>
): void
设置系统时区。
设置系统时区
,使用callback异步回调
。
**需要权限:**
ohos.permission.SET_TIME_ZONE
**需要权限:**
ohos.permission.SET_TIME_ZONE
...
@@ -387,29 +373,28 @@ setTimezone(timezone: string, callback: AsyncCallback<void>): void
...
@@ -387,29 +373,28 @@ setTimezone(timezone: string, callback: AsyncCallback<void>): void
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| timezone | string | 是 | 系统时区。 |
| timezone | string | 是 | 系统时区。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值
。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数
。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
setTimezone
(
'
Asia/Shanghai
'
,
(
error
,
data
)
=>
{
systemTime
.
setTimezone
(
'
Asia/Shanghai
'
,
(
error
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
error
(
'
failed to systemTime.setTimezone because
'
+
JSON
.
stringify
(
error
));
console
.
error
(
'
Failed to set systemTimeZone. Cause:
'
+
JSON
.
stringify
(
error
));
return
;
return
;
}
}
console
.
info
(
'
SystemTimePlugin systemTime.setTimezone success data :
'
+
JSON
.
stringify
(
data
));
console
.
info
(
'
Succeeded in setting systemTimeZone.
'
);
});
});
```
```
## systemTime.setTimezone
## systemTime.setTimezone
setTimezone(timezone: string): Promise
<
void
>
setTimezone(timezone: string): Promise
<
void
>
设置系统时区。
设置系统时区
,使用Promise异步回调
。
**需要权限:**
ohos.permission.SET_TIME_ZONE
**需要权限:**
ohos.permission.SET_TIME_ZONE
...
@@ -417,74 +402,72 @@ setTimezone(timezone: string): Promise<void>
...
@@ -417,74 +402,72 @@ setTimezone(timezone: string): Promise<void>
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| timezone | string | 是 | 系统时区。 |
| timezone | string | 是 | 系统时区。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
| Promise
<
void
>
| 返回的异步回调函数
。 |
| Promise
<
void
>
| 无返回结果的Promise对象
。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
setTimezone
(
'
Asia/Shanghai
'
).
then
((
data
)
=>
{
systemTime
.
setTimezone
(
'
Asia/Shanghai
'
).
then
(()
=>
{
console
.
log
(
`systemTime.setTimezone success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
'
Succeeded in setting systemTimeZone.
'
);
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
error
(
`failed to systemTime.setTimezone because: `
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to set systemTimeZone. Cause: `
+
JSON
.
stringify
(
error
));
});
});
```
```
## systemTime.getTimezone<sup>8+</sup>
## systemTime.getTimezone<sup>8+</sup>
getTimezone(callback: AsyncCallback
<
string
>
): void
getTimezone(callback: AsyncCallback
<
string
>
): void
获取系统时区,使用callback
形式返回结果
。
获取系统时区,使用callback
异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回系统时区。 |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回系统时区。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getTimezone
((
error
,
data
)
=>
{
systemTime
.
getTimezone
((
error
,
data
)
=>
{
if
(
error
)
{
if
(
error
)
{
console
.
error
(
`failed to systemTime.getTimezone because
`
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get systemTimeZone. Cause:
`
+
JSON
.
stringify
(
error
));
return
;
return
;
}
}
console
.
log
(
`systemTime.getTimezone success data : `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting systemTimeZone. Data: `
+
JSON
.
stringify
(
data
));
});
});
```
```
## systemTime.getTimezone<sup>8+</sup>
## systemTime.getTimezone<sup>8+</sup>
getTimezone(): Promise
<
string
>
getTimezone(): Promise
<
string
>
获取系统时区,使用Promise
形式返回结果
。
获取系统时区,使用Promise
异步回调
。
**系统能力:**
SystemCapability.MiscServices.Time
**系统能力:**
SystemCapability.MiscServices.Time
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| -------- | -------- |
| Promise
<
string
>
| 以Promise形式返回结果
,返回系统时区。 |
| Promise
<
string
>
| Promise对象
,返回系统时区。 |
**示例:**
**示例:**
```
js
```
js
systemTime
.
getTimezone
().
then
((
data
)
=>
{
systemTime
.
getTimezone
().
then
((
data
)
=>
{
console
.
log
(
`systemTime.getTimezone success data
: `
+
JSON
.
stringify
(
data
));
console
.
log
(
`Succeeded in getting systemTimeZone. Data
: `
+
JSON
.
stringify
(
data
));
}).
catch
((
error
)
=>
{
}).
catch
((
error
)
=>
{
console
.
error
(
`failed to systemTime.getTimezone because
`
+
JSON
.
stringify
(
error
));
console
.
error
(
`Failed to get systemTimeZone. Cause:
`
+
JSON
.
stringify
(
error
));
});
});
```
```
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录