未验证 提交 adb87681 编写于 作者: O openharmony_ci 提交者: Gitee

!5040 【轻量级 PR】:update zh-cn/application-dev/reference/apis/js-apis-system-time.md.

Merge pull request !5040 from 葛亚芳/N/A
# 设置系统时间 # 设置系统时间
本模块用来设置、获取当前系统时间,设置、获取当前系统日期和设置、获取当前系统时区 本模块主要由时间、时区和定时三大功能组成。其中,定时服务用来管理和使用时间、时区。开发者可以通过对系统进行设置、获取等操作管理系统时间、时区,也可以通过定时功能实现定时服务如闹钟服务等
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
...@@ -26,10 +26,10 @@ setTime(time : number, callback : AsyncCallback<void>) : void ...@@ -26,10 +26,10 @@ setTime(time : number, callback : AsyncCallback<void>) : void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | ------------------------- | ---- | ------------------------------------------ |
| time | number | 是 | 目标时间戳(ms)。 | | time | number | 是 | 目标时间戳(ms)。 |
| callback | AsyncCallback<void> | 是 | 回调函数,可以在回调函数中处理接口返回值。 | | callback | AsyncCallback<void> | 是 | 回调函数,可以在回调函数中处理接口返回值。 |
**示例:** **示例:**
...@@ -58,15 +58,15 @@ setTime(time : number) : Promise<void> ...@@ -58,15 +58,15 @@ setTime(time : number) : Promise<void>
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | ------ | ------ | ---- | ------------------ |
| time | number | 是 | 目标时间戳(ms)。 | | time | number | 是 | 目标时间戳(ms)。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | ------------------- | -------------------- |
| Promise<void> | 返回的异步回调函数。 | | Promise<void> | 返回的异步回调函数。 |
**示例:** **示例:**
...@@ -91,10 +91,10 @@ getCurrentTime(isNano?: boolean, callback: AsyncCallback<number>): void ...@@ -91,10 +91,10 @@ getCurrentTime(isNano?: boolean, callback: AsyncCallback<number>): void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 | | isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。 <br>- false:毫秒数。 <br> |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数,返回自&nbsp;Unix&nbsp;纪元以来经过的时间。 | | callback | AsyncCallback&lt;number&gt; | 是 | 回调函数,返回自&nbsp;Unix&nbsp;纪元以来经过的时间。 |
**示例:** **示例:**
...@@ -119,15 +119,15 @@ getCurrentTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -119,15 +119,15 @@ getCurrentTime(isNano?: boolean): Promise&lt;number&gt;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | ------ | ------- | ---- | ------------------------------------------------------------ |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 | | isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。 <br/>- false:毫秒数。 <br/> |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | --------------------- | ------------------------------------------------------------ |
| Promise&lt;number&gt; | 以Promise形式返回结果,返回自&nbsp;Unix&nbsp;纪元以来经过的时间。 | | Promise&lt;number&gt; | 以Promise形式返回结果,返回自&nbsp;Unix&nbsp;纪元以来经过的时间。 |
**示例:** **示例:**
...@@ -150,10 +150,10 @@ getRealActiveTime(isNano?: boolean, callback: AsyncCallback&lt;number&gt;): void ...@@ -150,10 +150,10 @@ getRealActiveTime(isNano?: boolean, callback: AsyncCallback&lt;number&gt;): void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 | | isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。 <br/>- false:毫秒数。 <br/> |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数,返回自系统启动以来但不包括度睡眠时间经过的时间。 | | callback | AsyncCallback&lt;number&gt; | 是 | 回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。 |
**示例:** **示例:**
...@@ -178,15 +178,15 @@ getRealActiveTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -178,15 +178,15 @@ getRealActiveTime(isNano?: boolean): Promise&lt;number&gt;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | ------ | ------- | ---- | ------------------------------------------------------------ |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 | | isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。 <br/>- false:毫秒数。 <br/> |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | --------------------- | ------------------------------------------------------------ |
| Promise&lt;number&gt; | 以Promise形式返回结果,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 | | Promise&lt;number&gt; | 以Promise形式返回结果,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 |
**示例:** **示例:**
...@@ -201,7 +201,7 @@ getRealActiveTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -201,7 +201,7 @@ getRealActiveTime(isNano?: boolean): Promise&lt;number&gt;
## systemTime.getRealTime<sup>8+</sup> ## systemTime.getRealTime<sup>8+</sup>
getRealTime(isNano?: boolean, callback: AsyncCallback&lt;number&gt;): void getRealTime(callback: AsyncCallback&lt;number&gt;): void
获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback形式返回结果。 获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback形式返回结果。
...@@ -209,10 +209,10 @@ getRealTime(isNano?: boolean, callback: AsyncCallback&lt;number&gt;): void ...@@ -209,10 +209,10 @@ getRealTime(isNano?: boolean, callback: AsyncCallback&lt;number&gt;): void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | --------------------------- | ---- | ------------------------------------------------------------ |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 | | isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。 <br/>- false:毫秒数。 <br/> |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 | | callback | AsyncCallback&lt;number&gt; | 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
**示例:** **示例:**
...@@ -229,7 +229,7 @@ getRealTime(isNano?: boolean, callback: AsyncCallback&lt;number&gt;): void ...@@ -229,7 +229,7 @@ getRealTime(isNano?: boolean, callback: AsyncCallback&lt;number&gt;): void
## systemTime.getRealTime<sup>8+</sup> ## systemTime.getRealTime<sup>8+</sup>
getRealTime(isNano?: boolean): Promise&lt;number&gt; getRealTime(): Promise&lt;number&gt;
获取自系统启动以来经过的时间,包括深度睡眠时间,使用Promise形式返回结果。 获取自系统启动以来经过的时间,包括深度睡眠时间,使用Promise形式返回结果。
...@@ -237,15 +237,15 @@ getRealTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -237,15 +237,15 @@ getRealTime(isNano?: boolean): Promise&lt;number&gt;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | ------ | ------- | ---- | ------------------------------------------------------------ |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 | | isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。 <br/>- false:毫秒数。 <br/> |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | --------------------- | ------------------------------------------------------------ |
| Promise&lt;number&gt; | 以Promise形式返回结果,返回自系统启动以来经过的时间,包括深度睡眠时间。 | | Promise&lt;number&gt; | 以Promise形式返回结果,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
**示例:** **示例:**
...@@ -270,10 +270,10 @@ setDate(date: Date, callback: AsyncCallback&lt;void&gt;): void ...@@ -270,10 +270,10 @@ setDate(date: Date, callback: AsyncCallback&lt;void&gt;): void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | ------------------------- | ---- | ------------------------------------------ |
| date | Date | 是 | 目标日期。 | | date | Date | 是 | 目标日期。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数,可以在回调函数中处理接口返回值。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数,可以在回调函数中处理接口返回值。 |
**示例:** **示例:**
...@@ -301,15 +301,15 @@ setDate(date: Date): Promise&lt;void&gt; ...@@ -301,15 +301,15 @@ setDate(date: Date): Promise&lt;void&gt;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | ------ | ---- | ---- | ---------- |
| date | Date | 是 | 目标日期。 | | date | Date | 是 | 目标日期。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | ------------------- | -------------------- |
| Promise&lt;void&gt; | 返回的异步回调函数。 | | Promise&lt;void&gt; | 返回的异步回调函数。 |
**示例:** **示例:**
...@@ -333,9 +333,9 @@ getDate(callback: AsyncCallback&lt;Date&gt;): void ...@@ -333,9 +333,9 @@ getDate(callback: AsyncCallback&lt;Date&gt;): void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | ------------------------- | ---- | ---------------------------- |
| callback | AsyncCallback&lt;Date&gt; | 是 | 回调函数,返回当前系统日期。 | | callback | AsyncCallback&lt;Date&gt; | 是 | 回调函数,返回当前系统日期。 |
**示例:** **示例:**
...@@ -360,9 +360,9 @@ getDate(): Promise&lt;Date&gt; ...@@ -360,9 +360,9 @@ getDate(): Promise&lt;Date&gt;
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | ------------------- | ----------------------------------------- |
| Promise&lt;Date&gt; | 以Promise形式返回结果,返回当前系统日期。 | | Promise&lt;Date&gt; | 以Promise形式返回结果,返回当前系统日期。 |
**示例:** **示例:**
...@@ -387,10 +387,10 @@ setTimezone(timezone: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -387,10 +387,10 @@ setTimezone(timezone: string, callback: AsyncCallback&lt;void&gt;): void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | ------------------------- | ---- | ------------------------------------------ |
| timezone | string | 是 | 系统时区。 | | timezone | string | 是 | 系统时区。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数,可以在回调函数中处理接口返回值。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数,可以在回调函数中处理接口返回值。 |
**示例:** **示例:**
...@@ -417,15 +417,15 @@ setTimezone(timezone: string): Promise&lt;void&gt; ...@@ -417,15 +417,15 @@ setTimezone(timezone: string): Promise&lt;void&gt;
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | ------ | ---- | ---------- |
| timezone | string | 是 | 系统时区。 | | timezone | string | 是 | 系统时区。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | ------------------- | -------------------- |
| Promise&lt;void&gt; | 返回的异步回调函数。 | | Promise&lt;void&gt; | 返回的异步回调函数。 |
**示例:** **示例:**
...@@ -448,9 +448,9 @@ getTimezone(callback: AsyncCallback&lt;string&gt;): void ...@@ -448,9 +448,9 @@ getTimezone(callback: AsyncCallback&lt;string&gt;): void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | --------------------------- | ---- | ------------------------ |
| callback | AsyncCallback&lt;string&gt; | 是 | 回调函数,返回系统时区。 | | callback | AsyncCallback&lt;string&gt; | 是 | 回调函数,返回系统时区。 |
**示例:** **示例:**
...@@ -475,9 +475,9 @@ getTimezone(): Promise&lt;string&gt; ...@@ -475,9 +475,9 @@ getTimezone(): Promise&lt;string&gt;
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | --------------------- | ------------------------------------- |
| Promise&lt;string&gt; | 以Promise形式返回结果,返回系统时区。 | | Promise&lt;string&gt; | 以Promise形式返回结果,返回系统时区。 |
**示例:** **示例:**
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册