Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
0648f570
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看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
0648f570
编写于
9月 09, 2022
作者:
O
openharmony_ci
提交者:
Gitee
9月 09, 2022
浏览文件
操作
浏览文件
下载
差异文件
!9318 修改时间时区md资料
Merge pull request !9318 from lijuntao/master
上级
26afdf0e
f9519710
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
107 addition
and
17 deletion
+107
-17
zh-cn/application-dev/reference/apis/js-apis-system-time.md
zh-cn/application-dev/reference/apis/js-apis-system-time.md
+86
-4
zh-cn/application-dev/reference/apis/js-apis-system-timer.md
zh-cn/application-dev/reference/apis/js-apis-system-timer.md
+21
-13
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-system-time.md
浏览文件 @
0648f570
...
...
@@ -4,7 +4,6 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
>- 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>- 本模块接口为系统接口,三方应用不支持调用。
## 导入模块
...
...
@@ -83,7 +82,7 @@ setTime(time : number) : Promise<void>
## systemTime.getCurrentTime<sup>8+</sup>
getCurrentTime(isNano
?
: boolean, callback: AsyncCallback
<
number
>
): void
getCurrentTime(isNano: boolean, callback: AsyncCallback
<
number
>
): void
获取自 Unix 纪元以来经过的时间,使用callback形式返回结果。
...
...
@@ -109,6 +108,34 @@ getCurrentTime(isNano?: boolean, callback: AsyncCallback<number>): void
```
## systemTime.getCurrentTime<sup>8+</sup>
getCurrentTime(callback: AsyncCallback
<
number
>
): void
获取自 Unix 纪元以来经过的时间,使用callback形式返回结果。
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。
<br>
- false:毫秒数。
<br>
|
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自
Unix
纪元以来经过的时间。 |
**示例:**
```
js
systemTime
.
getCurrentTime
((
error
,
data
)
=>
{
if
(
error
)
{
console
.
error
(
`failed to systemTime.getCurrentTime because `
+
JSON
.
stringify
(
error
));
return
;
}
console
.
log
(
`systemTime.getCurrentTime success data : `
+
JSON
.
stringify
(
data
));
});
```
## systemTime.getCurrentTime<sup>8+</sup>
getCurrentTime(isNano?: boolean): Promise
<
number
>
...
...
@@ -142,7 +169,7 @@ getCurrentTime(isNano?: boolean): Promise<number>
## systemTime.getRealActiveTime<sup>8+</sup>
getRealActiveTime(isNano
?
: boolean, callback: AsyncCallback
<
number
>
): void
getRealActiveTime(isNano: boolean, callback: AsyncCallback
<
number
>
): void
获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback形式返回结果。
...
...
@@ -166,7 +193,35 @@ getRealActiveTime(isNano?: boolean, callback: AsyncCallback<number>): void
console
.
log
(
`systemTime.getRealActiveTime success data : `
+
JSON
.
stringify
(
data
));
});
```
## systemTime.getRealActiveTime<sup>8+</sup>
getRealActiveTime(callback: AsyncCallback
<
number
>
): void
获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback形式返回结果。
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。
<br/>
- false:毫秒数。
<br/>
|
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。 |
**示例:**
```
js
systemTime
.
getRealActiveTime
((
error
,
data
)
=>
{
if
(
error
)
{
console
.
error
(
`failed to systemTime.getRealActiveTimebecause `
+
JSON
.
stringify
(
error
));
return
;
}
console
.
log
(
`systemTime.getRealActiveTime success data : `
+
JSON
.
stringify
(
data
));
});
```
## systemTime.getRealActiveTime<sup>8+</sup>
...
...
@@ -201,7 +256,7 @@ getRealActiveTime(isNano?: boolean): Promise<number>
## systemTime.getRealTime<sup>8+</sup>
getRealTime(isNano
?
: boolean, callback: AsyncCallback
<
number
>
): void
getRealTime(isNano: boolean, callback: AsyncCallback
<
number
>
): void
获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback形式返回结果。
...
...
@@ -229,6 +284,33 @@ getRealTime(isNano?: boolean, callback: AsyncCallback<number>): void
## systemTime.getRealTime<sup>8+</sup>
getRealTime(callback: AsyncCallback
<
number
>
): void
获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback形式返回结果。
**系统能力:**
SystemCapability.MiscServices.Time
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。
<br/>
- false:毫秒数。
<br/>
|
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
**示例:**
```
js
systemTime
.
getRealTime
((
error
,
data
)
=>
{
if
(
error
)
{
console
.
error
(
`failed to systemTime.getRealTime because `
+
JSON
.
stringify
(
error
));
return
;
}
console
.
log
(
`systemTime.getRealTime success data: `
+
JSON
.
stringify
(
data
));
});
```
## systemTime.getRealTime<sup>8+</sup>
getRealTime(isNano?: boolean): Promise
<
number
>
获取自系统启动以来经过的时间,包括深度睡眠时间,使用Promise形式返回结果。
...
...
zh-cn/application-dev/reference/apis/js-apis-system-timer.md
浏览文件 @
0648f570
...
...
@@ -24,12 +24,9 @@ createTimer(options: TimerOptions, callback: AsyncCallback<number>): void
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------| ---- | --------------------------------------------------------------------------------------- |
| options | TimerOptions | 是 | const TIMER_TYPE_REALTIME: 设置为系统启动时间定时器,否则为walltime定时器;
<br/>
const TIMER_TYPE_WAKEUP: 设置为唤醒定时器,否则为非唤醒;
<br/>
const TIMER_TYPE_EXACT: 设置为精准定时器,否则为非精准定时器;
<br/>
const TIMER_TYPE_IDLE: number: 设置为IDLE模式定时器,否则为非IDLE模式定时器(暂不支持) |
| repeat | boolean | 是 | true 为循环定时器,false为单次定时器。 |
| interval | number | 否 | 如果是循环定时器,repeat值应大于5000毫秒,非重复定时器置为0。 |
| wantAgent| wantAgent | 否 | 设置通知的wantagent,定时器到期后通知。(支持拉起鸿蒙应用MainAbility,暂不支持拉起SA) |
| 名称 | 类型 | 必填 | 说明 |
| ------- | ---------------------------------| ---- | --------------------------------------------------------------------------- |
| options |
[
TimerOptions
](
#timeroptions
)
| 是 | 创建系统定时器,包括定时器类型,是否循环触发,间隔时间,WantAgent通知机制。 |
**返回值:**
...
...
@@ -68,12 +65,9 @@ createTimer(options: TimerOptions): Promise<number>
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------| ---- | --------------------------------------------------------------------------------------- |
| options | TimerOptions | 是 | const TIMER_TYPE_REALTIME: 设置为系统启动时间定时器,否则为walltime定时器;
<br/>
const TIMER_TYPE_WAKEUP: 设置为唤醒定时器,否则为非唤醒;
<br/>
const TIMER_TYPE_EXACT: 设置为精准定时器,否则为非精准定时器;
<br/>
const TIMER_TYPE_IDLE: number: 设置为IDLE模式定时器,否则为非IDLE模式定时器(暂不支持) |
| repeat | boolean | 是 | true 为循环定时器,false为单次定时器。 |
| interval | number | 否 | 如果是循环定时器,repeat值应大于5000毫秒,非重复定时器置为0。 |
| wantAgent| wantAgent | 否 | 设置通知的wantagent,定时器到期后通知。(支持拉起鸿蒙应用MainAbility,暂不支持拉起SA) |
| 名称 | 类型 | 必填 | 说明 |
| ------- | ---------------------------------| ---- | --------------------------------------------------------------------------- |
| options |
[
TimerOptions
](
#timeroptions
)
| 是 | 创建系统定时器,包括定时器类型,是否循环触发,间隔时间,WantAgent通知机制。 |
**返回值:**
...
...
@@ -316,4 +310,18 @@ export default {
});
}
}
```
\ No newline at end of file
```
## TimerOptions
createTimer的初始化选项。
**系统能力:**
SystemCapability.MiscServices.Time
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------| ---- | ----------------------------------------------------------------------------------------------- |
| type | number | 是 | const TIMER_TYPE_REALTIME: 设置为系统启动时间定时器,否则为walltime定时器;
<br/>
const TIMER_TYPE_WAKEUP: 设置为唤醒定时器,否则为非唤醒;
<br/>
const TIMER_TYPE_EXACT: 设置为精准定时器,否则为非精准定时器;
<br/>
const TIMER_TYPE_IDLE: number: 设置为IDLE模式定时器,否则为非IDLE模式定时器(暂不支持) |
| repeat | boolean | 是 | true 为循环定时器,false为单次定时器。 |
| interval | number | 否 | 如果是循环定时器,repeat值应大于5000毫秒,非重复定时器置为0。 |
| wantAgent| wantAgent | 否 | 设置通知的wantagent,定时器到期后通知。(支持拉起应用MainAbility,暂不支持拉起ServiceAbility) |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录