Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
647ac5ba
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看板
未验证
提交
647ac5ba
编写于
5月 12, 2022
作者:
孙
孙悦
提交者:
Gitee
5月 12, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/application-dev/reference/apis/js-apis-system-time.md.
Signed-off-by:
N
sunyue
<
sunyue77@h-partners.com
>
上级
502ace34
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
88 addition
and
65 deletion
+88
-65
zh-cn/application-dev/reference/apis/js-apis-system-time.md
zh-cn/application-dev/reference/apis/js-apis-system-time.md
+88
-65
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-system-time.md
浏览文件 @
647ac5ba
# 设置系统时间
本模块用来设置、获取当前系统时间,设置、获取当前系统日期和设置、获取当前系统时区。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
...
...
@@ -22,13 +23,14 @@ setTime(time : number, callback : AsyncCallback<void>) : void
**系统能力:**
SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| time | number | 是 | 目标时间戳(
毫秒
)。 |
| time | number | 是 | 目标时间戳(
ms
)。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值。 |
-
示例:
**示例:**
```
js
// time对应的时间为2021-01-20 02:36:25
...
...
@@ -53,17 +55,19 @@ setTime(time : number) : Promise<void>
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| time | number | 是 | 目标时间戳(毫秒)。 |
| time | number | 是 | 目标时间戳(ms)。 |
**返回值:**
-
返回值:
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| 返回的异步回调函数。 |
-
示例:
**示例:**
```
js
// time对应的时间为2021-01-20 02:36:25
...
...
@@ -84,13 +88,14 @@ getCurrentTime(isNano?: boolean, callback: AsyncCallback<number>): void
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自
Unix
纪元以来经过的时间。 |
-
示例:
**示例:**
```
js
systemTime
.
getCurrentTime
(
true
,
(
error
,
data
)
=>
{
...
...
@@ -111,17 +116,19 @@ getCurrentTime(isNano?: boolean): Promise<number>
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
-
返回值:
| 类型 | 说明 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 以Promise形式返回结果,返回自
Unix
纪元以来经过的时间。 |
-
示例:
**示例:**
```
js
systemTime
.
getCurrentTime
().
then
((
data
)
=>
{
...
...
@@ -140,13 +147,14 @@ getRealActiveTime(isNano?: boolean, callback: AsyncCallback<number>): void
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来但不包括度睡眠时间经过的时间。 |
-
示例:
**示例:**
```
js
systemTime
.
getRealActiveTime
(
true
,
(
error
,
data
)
=>
{
...
...
@@ -167,17 +175,19 @@ getRealActiveTime(isNano?: boolean): Promise<number>
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
-
返回值:
| 类型 | 说明 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 以Promise形式返回结果,返回自系统启动以来
但不包括度睡眠时间经过的
时间。 |
| Promise
<
number
>
| 以Promise形式返回结果,返回自系统启动以来
经过的时间,但不包括深度睡眠
时间。 |
-
示例:
**示例:**
```
js
systemTime
.
getCurrentTime
().
then
((
data
)
=>
{
...
...
@@ -196,13 +206,14 @@ getRealTime(callback: AsyncCallback<number>): void
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来
包括深度睡眠时间经过的毫秒数
。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来
经过的时间,包括深度睡眠时间
。 |
-
示例:
**示例:**
```
js
systemTime
.
getRealTime
(
true
,
(
error
,
data
)
=>
{
...
...
@@ -223,17 +234,19 @@ getRealTime(): Promise<number>
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
-
返回值:
| 类型 | 说明 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 以Promise形式返回结果,返回自系统启动以来
包括深度睡眠时间经过的
时间。 |
| Promise
<
number
>
| 以Promise形式返回结果,返回自系统启动以来
经过的时间,包括深度睡眠
时间。 |
-
示例:
**示例:**
```
js
systemTime
.
getRealTime
().
then
((
data
)
=>
{
...
...
@@ -254,13 +267,14 @@ setDate(date: Date, callback: AsyncCallback<void>): void
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| date | Date | 是 | 目标日期。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值。 |
-
示例:
**示例:**
```
js
var
data
=
new
Date
(
"
October 13, 2020 11:13:00
"
);
...
...
@@ -284,17 +298,19 @@ setDate(date: Date): Promise<void>
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| date | Date | 是 | 目标日期。 |
-
返回值:
| 类型 | 说明 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| 返回的异步回调函数。 |
-
示例:
**示例:**
```
js
var
data
=
new
Date
(
"
October 13, 2020 11:13:00
"
);
...
...
@@ -314,12 +330,13 @@ getDate(callback: AsyncCallback<Date>): void
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
Date
>
| 是 | 回调函数,返回当前系统日期。 |
-
示例:
**示例:**
```
js
systemTime
.
getDate
((
error
,
data
)
=>
{
...
...
@@ -340,12 +357,13 @@ getDate(): Promise<Date>
**系统能力:**
SystemCapability.MiscServices.Time
-
返回值:
| 类型 | 说明 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
Date
>
| 以Promise形式返回结果,返回当前系统日期。 |
-
示例:
**示例:**
```
js
systemTime
.
getDate
().
then
((
data
)
=>
{
...
...
@@ -366,13 +384,14 @@ setTimezone(timezone: string, callback: AsyncCallback<void>): void
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| timezone | string | 是 | 系统时区。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值。 |
-
示例:
**示例:**
```
js
systemTime
.
setTimezone
(
'
Asia/Shanghai
'
,
(
error
,
data
)
=>
{
...
...
@@ -395,17 +414,19 @@ setTimezone(timezone: string): Promise<void>
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| timezone | string | 是 | 系统时区。 |
-
返回值:
| 类型 | 说明 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| 返回的异步回调函数。 |
-
示例:
**示例:**
```
js
systemTime
.
setTimezone
(
'
Asia/Shanghai
'
).
then
((
data
)
=>
{
...
...
@@ -424,12 +445,13 @@ getTimezone(callback: AsyncCallback<string>): void
**系统能力:**
SystemCapability.MiscServices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回系统时区。 |
-
示例:
**示例:**
```
js
systemTime
.
getTimezone
((
error
,
data
)
=>
{
...
...
@@ -450,12 +472,13 @@ getTimezone(): Promise<string>
**系统能力:**
SystemCapability.MiscServices.Time
-
返回值:
| 类型 | 说明 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
string
>
| 以Promise形式返回结果,返回系统时区。 |
-
示例:
**示例:**
```
js
systemTime
.
getTimezone
().
then
((
data
)
=>
{
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录