提交 851d0ff2 编写于 作者: W wangtong

feat:add new time api

Signed-off-by: Nwangtong <wangtong94@huawei.com>
上级 98a78931
...@@ -12,6 +12,18 @@ ...@@ -12,6 +12,18 @@
import systemDateTime from '@ohos.systemDateTime'; import systemDateTime from '@ohos.systemDateTime';
``` ```
## TimeType<sup>10+</sup>
定义获取时间的枚举类型。
**系统能力**: SystemCapability.MiscServices.Time
| 名称 | 值 | 说明 |
| ---------------- | ---- | ------------------------------------------------ |
| CLOCK_TIME | 0 | 自 Unix 纪元以来经过的毫秒数。 |
| REAL_ACTIVE_TIME | 1 | 自系统启动以来经过的毫秒数,不包括深度睡眠时间。 |
| REAL_TIME | 2 | 自系统启动以来经过的毫秒数,包括深度睡眠时间。 |
## systemDateTime.setTime ## systemDateTime.setTime
setTime(time : number, callback : AsyncCallback&lt;void&gt;) : void setTime(time : number, callback : AsyncCallback&lt;void&gt;) : void
...@@ -85,7 +97,7 @@ try { ...@@ -85,7 +97,7 @@ try {
} }
``` ```
## systemDateTime.getCurrentTime ## systemDateTime.getCurrentTime<sup>(deprecated)</sup>
getCurrentTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void getCurrentTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
...@@ -116,7 +128,7 @@ try { ...@@ -116,7 +128,7 @@ try {
} }
``` ```
## systemDateTime.getCurrentTime ## systemDateTime.getCurrentTime<sup>(deprecated)</sup>
getCurrentTime(callback: AsyncCallback&lt;number&gt;): void getCurrentTime(callback: AsyncCallback&lt;number&gt;): void
...@@ -146,7 +158,7 @@ try { ...@@ -146,7 +158,7 @@ try {
} }
``` ```
## systemDateTime.getCurrentTime ## systemDateTime.getCurrentTime<sup>(deprecated)</sup>
getCurrentTime(isNano?: boolean): Promise&lt;number&gt; getCurrentTime(isNano?: boolean): Promise&lt;number&gt;
...@@ -180,7 +192,7 @@ try { ...@@ -180,7 +192,7 @@ try {
} }
``` ```
## systemDateTime.getRealActiveTime ## systemDateTime.getRealActiveTime<sup>(deprecated)</sup>
getRealActiveTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void getRealActiveTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
...@@ -211,7 +223,7 @@ try { ...@@ -211,7 +223,7 @@ try {
} }
``` ```
## systemDateTime.getRealActiveTime ## systemDateTime.getRealActiveTime<sup>(deprecated)</sup>
getRealActiveTime(callback: AsyncCallback&lt;number&gt;): void getRealActiveTime(callback: AsyncCallback&lt;number&gt;): void
...@@ -241,7 +253,7 @@ try { ...@@ -241,7 +253,7 @@ try {
} }
``` ```
## systemDateTime.getRealActiveTime ## systemDateTime.getRealActiveTime<sup>(deprecated)</sup>
getRealActiveTime(isNano?: boolean): Promise&lt;number&gt; getRealActiveTime(isNano?: boolean): Promise&lt;number&gt;
...@@ -275,7 +287,7 @@ try { ...@@ -275,7 +287,7 @@ try {
} }
``` ```
## systemDateTime.getRealTime ## systemDateTime.getRealTime<sup>(deprecated)</sup>
getRealTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void getRealTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
...@@ -306,7 +318,7 @@ try { ...@@ -306,7 +318,7 @@ try {
} }
``` ```
## systemDateTime.getRealTime ## systemDateTime.getRealTime<sup>(deprecated)</sup>
getRealTime(callback: AsyncCallback&lt;number&gt;): void getRealTime(callback: AsyncCallback&lt;number&gt;): void
...@@ -336,7 +348,7 @@ try { ...@@ -336,7 +348,7 @@ try {
} }
``` ```
## systemDateTime.getRealTime ## systemDateTime.getRealTime<sup>(deprecated)</sup>
getRealTime(isNano?: boolean): Promise&lt;number&gt; getRealTime(isNano?: boolean): Promise&lt;number&gt;
...@@ -370,7 +382,34 @@ try { ...@@ -370,7 +382,34 @@ try {
} }
``` ```
## systemDateTime.setDate ## systemDateTime.getTimeSync<sup>10+</sup>
getTimeSync(timeType:TimeType, isNano: boolean): number
获取不同类型时间,使用同步方式。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ------------------------------------------------------------ |
| timeType | [TimeType](#timetype) | 是 | 获取的时间类型。 |
| isNano | boolean | 否 | 返回结果是否为纳秒数。<br>默认值为false。<br>- true:表示返回结果为纳秒数(ns)。 <br>- false:表示返回结果为毫秒数(ms)。 |
**返回值**
| 类型 | 说明 |
| ------ | ------------ |
| number | 返回时间戳。 |
**示例:**
```js
let time = systemDateTime.getTimeSync(TimeType.CLOCK_TIME, true)
```
## systemDateTime.setDate<sup>(deprecated)</sup>
setDate(date: Date, callback: AsyncCallback&lt;void&gt;): void setDate(date: Date, callback: AsyncCallback&lt;void&gt;): void
...@@ -404,7 +443,7 @@ try { ...@@ -404,7 +443,7 @@ try {
} }
``` ```
## systemDateTime.setDate ## systemDateTime.setDate<sup>(deprecated)</sup>
setDate(date: Date): Promise&lt;void&gt; setDate(date: Date): Promise&lt;void&gt;
...@@ -441,7 +480,7 @@ try { ...@@ -441,7 +480,7 @@ try {
} }
``` ```
## systemDateTime.getDate ## systemDateTime.getDate<sup>(deprecated)</sup>
getDate(callback: AsyncCallback&lt;Date&gt;): void getDate(callback: AsyncCallback&lt;Date&gt;): void
...@@ -471,7 +510,7 @@ try { ...@@ -471,7 +510,7 @@ try {
} }
``` ```
## systemDateTime.getDate ## systemDateTime.getDate<sup>(deprecated)</sup>
getDate(): Promise&lt;Date&gt; getDate(): Promise&lt;Date&gt;
...@@ -568,7 +607,7 @@ try { ...@@ -568,7 +607,7 @@ try {
} }
``` ```
## systemDateTime.getTimezone ## systemDateTime.getTimezone<sup>(deprecated)</sup>
getTimezone(callback: AsyncCallback&lt;string&gt;): void getTimezone(callback: AsyncCallback&lt;string&gt;): void
...@@ -598,7 +637,7 @@ try { ...@@ -598,7 +637,7 @@ try {
} }
``` ```
## systemDateTime.getTimezone ## systemDateTime.getTimezone<sup>(deprecated)</sup>
getTimezone(): Promise&lt;string&gt; getTimezone(): Promise&lt;string&gt;
...@@ -626,6 +665,26 @@ try { ...@@ -626,6 +665,26 @@ try {
} }
``` ```
## systemDateTime.getTimezoneSync<sup>10+</sup>
getTimezoneSync(): string
获取系统时区,使用同步方式。
**系统能力:** SystemCapability.MiscServices.Time
**返回值:**
| 类型 | 说明 |
| ------ | ---------------------------------------------------------- |
| string | 返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 |
**示例:**
```js
let timezone = systemDateTime.getTimezoneSync();
```
## 支持的系统时区 ## 支持的系统时区
支持的系统时区及各时区与0时区相比的偏移量(单位:h)可见下表。 支持的系统时区及各时区与0时区相比的偏移量(单位:h)可见下表。
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册