diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-time.md b/zh-cn/application-dev/reference/apis/js-apis-system-time.md
index 2147c418222723f385189fe4256a0259f443e754..d71b6e72fbadc966cd6a51bbc42658513da0b96d 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-system-time.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-system-time.md
@@ -2,22 +2,21 @@
本模块主要由系统时间和系统时区功能组成。开发者可以设置、获取系统时间及系统时区。
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
->- 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
+> **说明:**
+>
+> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
-
-```
+```js
import systemTime from '@ohos.systemTime';
```
-
## systemTime.setTime
setTime(time : number, callback : AsyncCallback<void>) : void
-设置系统时间。
+设置系统时间,使用callback异步回调。
**需要权限:** ohos.permission.SET_TIME
@@ -25,31 +24,30 @@ setTime(time : number, callback : AsyncCallback<void>) : void
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ------------------------- | ---- | ------------------------------------------ |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------- | ---- | ---------------- |
| time | number | 是 | 目标时间戳(ms)。 |
-| callback | AsyncCallback<void> | 是 | 回调函数,可以在回调函数中处理接口返回值。 |
+| callback | AsyncCallback<void> | 是 | 回调函数。 |
**示例:**
- ```js
- // time对应的时间为2021-01-20 02:36:25
- var time = 1611081385000;
- systemTime.setTime(time, (error, data) => {
- if (error) {
- console.error(`failed to systemTime.setTime because ` + JSON.stringify(error));
- return;
- }
- console.log(`systemTime.setTime success data : ` + JSON.stringify(data));
- });
- ```
-
+```js
+// time对应的时间为2021-01-20 02:36:25
+let time = 1611081385000;
+systemTime.setTime(time, (error, data) => {
+ if (error) {
+ console.error(`Failed to set systemTime. Cause:` + JSON.stringify(error));
+ return;
+ }
+ console.log(`Succeeded in setting systemTime. Data:` + JSON.stringify(data));
+});
+```
## systemTime.setTime
setTime(time : number) : Promise<void>
-设置系统时间。
+设置系统时间,使用Promise异步回调。
**需要权限:** ohos.permission.SET_TIME
@@ -63,285 +61,276 @@ setTime(time : number) : Promise<void>
**返回值:**
-| 类型 | 说明 |
-| ------------------- | -------------------- |
-| Promise<void> | 返回的异步回调函数。 |
+| 类型 | 说明 |
+| ------------------- | ------------------------- |
+| Promise<void> | 无返回结果的Promise对象。 |
**示例:**
- ```js
- // time对应的时间为2021-01-20 02:36:25
- var time = 1611081385000;
- systemTime.setTime(time).then((data) => {
- console.log(`systemTime.setTime success data : ` + JSON.stringify(data));
- }).catch((error) => {
- console.error(`failed to systemTime.setTime because ` + JSON.stringify(error));
- });
- ```
-
+```js
+// time对应的时间为2021-01-20 02:36:25
+let time = 1611081385000;
+systemTime.setTime(time).then((data) => {
+ console.log(`Succeeded in setting systemTime. Data:` + JSON.stringify(data));
+}).catch((error) => {
+ console.error(`Failed to set systemTime. Cause:` + JSON.stringify(error));
+});
+```
## systemTime.getCurrentTime8+
getCurrentTime(isNano: boolean, callback: AsyncCallback<number>): void
-获取自 Unix 纪元以来经过的时间,使用callback形式返回结果。
+获取自Unix纪元以来经过的时间,使用callback异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
-| isNano | boolean | 是 | 返回结果是否为纳秒数。 - true:纳秒数。
- false:毫秒数。
|
-| callback | AsyncCallback<number> | 是 | 回调函数,返回自 Unix 纪元以来经过的时间。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------- | ---- | ------------------ |
+| isNano | boolean | 是 | 返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。 |
+| callback | AsyncCallback<number> | 是 | 回调函数,返回自Unix纪元以来经过的时间。 |
**示例:**
- ```js
- systemTime.getCurrentTime(true, (error, data) => {
- if (error) {
- console.error(`failed to systemTime.getCurrentTime because ` + JSON.stringify(error));
- return;
- }
- console.log(`systemTime.getCurrentTime success data : ` + JSON.stringify(data));
- });
- ```
-
+```js
+systemTime.getCurrentTime(true, (error, data) => {
+ if (error) {
+ console.error(`Failed to get systemTime. Cause:` + JSON.stringify(error));
+ return;
+ }
+ console.log(`Succeeded in getting systemTime. Data:` + JSON.stringify(data));
+});
+```
## systemTime.getCurrentTime8+
getCurrentTime(callback: AsyncCallback<number>): void
-获取自 Unix 纪元以来经过的时间,使用callback形式返回结果。
+获取自Unix纪元以来经过的时间,使用callback异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
-| callback | AsyncCallback<number> | 是 | 回调函数,返回自 Unix 纪元以来经过的时间。 |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------- | ---- | ---------------------------------- |
+| 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));
- });
- ```
-
+```js
+systemTime.getCurrentTime((error, data) => {
+ if (error) {
+ console.error(`Succeeded in getting systemTime. Data:` + JSON.stringify(error));
+ return;
+ }
+ console.log(`Failed to get systemTime. Cause:` + JSON.stringify(data));
+});
+```
## systemTime.getCurrentTime8+
getCurrentTime(isNano?: boolean): Promise<number>
-获取自 Unix 纪元以来经过的时间,使用Promise形式返回结果。
+获取自Unix纪元以来经过的时间,使用Promise异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ------- | ---- | ------------------------------------------------------------ |
-| isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。
- false:毫秒数。
|
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------- | ---- | ------------------------- |
+| isNano | boolean | 否 | 返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。 |
**返回值:**
-| 类型 | 说明 |
-| --------------------- | ------------------------------------------------------------ |
-| Promise<number> | 以Promise形式返回结果,返回自 Unix 纪元以来经过的时间。 |
+| 类型 | 说明 |
+| --------------------- | --------------------------- |
+| Promise<number> | Promise对象,返回自Unix纪元以来经过的时间。 |
**示例:**
- ```js
- systemTime.getCurrentTime().then((data) => {
- console.log(`systemTime.getCurrentTime success data : ` + JSON.stringify(data));
- }).catch((error) => {
- console.error(`failed to systemTime.getCurrentTime because ` + JSON.stringify(error));
- });
- ```
-
+```js
+systemTime.getCurrentTime().then((data) => {
+ console.log(`Succeeded in getting systemTime. Data:` + JSON.stringify(data));
+}).catch((error) => {
+ console.error(`Failed to get systemTime. Cause:` + JSON.stringify(error));
+});
+```
## systemTime.getRealActiveTime8+
getRealActiveTime(isNano: boolean, callback: AsyncCallback<number>): void
-获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback形式返回结果。
+获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
-| isNano | boolean | 是 | 返回结果是否为纳秒数。 - true:纳秒数。
- false:毫秒数。
|
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------- | ---- | -------------------------- |
+| isNano | boolean | 是 | 返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。 |
| callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。 |
**示例:**
- ```js
- systemTime.getRealActiveTime(true, (error, data) => {
- if (error) {
- console.error(`failed to systemTime.getRealActiveTimebecause ` + JSON.stringify(error));
- return;
- }
- console.log(`systemTime.getRealActiveTime success data : ` + JSON.stringify(data));
- });
- ```
-
+```js
+systemTime.getRealActiveTime(true, (error, data) => {
+ if (error) {
+ console.error(`Failed to get real active time. Cause:` + JSON.stringify(error));
+ return;
+ }
+ console.log(`Succeeded in getting real active time. Data:` + JSON.stringify(data));
+});
+```
## systemTime.getRealActiveTime8+
getRealActiveTime(callback: AsyncCallback<number>): void
-获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback形式返回结果。
+获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------- | ---- | --------------------- |
| 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));
- });
- ```
-
+```js
+systemTime.getRealActiveTime((error, data) => {
+ if (error) {
+ console.error(`Failed to get real active time. Cause:` + JSON.stringify(error));
+ return;
+ }
+ console.log(`Succeeded in getting real active time. Data:` + JSON.stringify(data));
+});
+```
## systemTime.getRealActiveTime8+
getRealActiveTime(isNano?: boolean): Promise<number>
-获取自系统启动以来经过的时间,不包括深度睡眠时间,使用Promise形式返回结果。
+获取自系统启动以来经过的时间,不包括深度睡眠时间,使用Promise异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ------- | ---- | ------------------------------------------------------------ |
-| isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。
- false:毫秒数。
|
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------- | ---- | ----------------------------------- |
+| isNano | boolean | 否 | 返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。 |
**返回值:**
-| 类型 | 说明 |
-| --------------------- | ------------------------------------------------------------ |
-| Promise<number> | 以Promise形式返回结果,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 |
+| 类型 | 说明 |
+| -------------- | -------------------------------- |
+| Promise<number> | Promise对象,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 |
**示例:**
- ```js
- systemTime.getRealActiveTime().then((data) => {
- console.log(`systemTime.getRealActiveTime success data : ` + JSON.stringify(data));
- }).catch((error) => {
- console.error(`failed to systemTime.getRealActiveTime because ` + JSON.stringify(error));
- });
- ```
-
+```js
+systemTime.getRealActiveTime().then((data) => {
+ console.log(`Succeeded in getting real active time. Data:` + JSON.stringify(data));
+}).catch((error) => {
+ console.error(`Failed to get real active time. Cause:` + JSON.stringify(error));
+});
+```
## systemTime.getRealTime8+
getRealTime(isNano: boolean, callback: AsyncCallback<number>): void
-获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback形式返回结果。
+获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
-| isNano | boolean | 是 | 返回结果是否为纳秒数。 - true:纳秒数。
- false:毫秒数。
|
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | --------------- | ---- | ------------------------------- |
+| isNano | boolean | 是 | 返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。 |
| callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
**示例:**
- ```js
- systemTime.getRealTime(true, (error, data) => {
- if (error) {
- console.error(`failed to systemTime.getRealTime because ` + JSON.stringify(error));
- return;
- }
- console.log(`systemTime.getRealTime success data: ` + JSON.stringify(data));
- });
- ```
-
+```js
+systemTime.getRealTime(true, (error, data) => {
+ if (error) {
+ console.error(`Failed to get real time. Cause:` + JSON.stringify(error));
+ return;
+ }
+ console.log(`Succeeded in getting real time. Data:` + JSON.stringify(data));
+});
+```
## systemTime.getRealTime8+
getRealTime(callback: AsyncCallback<number>): void
-获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback形式返回结果。
+获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | --------- | ---- | --------------------------- |
| 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));
- });
- ```
+```js
+systemTime.getRealTime((error, data) => {
+ if (error) {
+ console.error(`Failed to get real time. Cause:` + JSON.stringify(error));
+ return;
+ }
+ console.log(`Succeeded in getting real time. Data:` + JSON.stringify(data));
+});
+```
## systemTime.getRealTime8+
getRealTime(isNano?: boolean): Promise<number>
-获取自系统启动以来经过的时间,包括深度睡眠时间,使用Promise形式返回结果。
+获取自系统启动以来经过的时间,包括深度睡眠时间,使用Promise异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| ------ | ------- | ---- | ------------------------------------------------------------ |
-| isNano | boolean | 否 | 返回结果是否为纳秒数。 - true:纳秒数。
- false:毫秒数。
|
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------- | ---- | ------------------------------- |
+| isNano | boolean | 否 | 返回结果是否为纳秒数。<
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。 |
**返回值:**
-| 类型 | 说明 |
-| --------------------- | ------------------------------------------------------------ |
-| Promise<number> | 以Promise形式返回结果,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
+| 类型 | 说明 |
+| --------------------- | ------------------------------- |
+| Promise<number> | Promise对象,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
**示例:**
- ```js
- systemTime.getRealTime().then((data) => {
- console.log(`systemTime.getRealTime success data: ` + JSON.stringify(data));
- }).catch((error) => {
- console.error(`failed to systemTime.getRealTime because ` + JSON.stringify(error));
- });
- ```
-
+```js
+systemTime.getRealTime().then((data) => {
+ console.log(`Succeeded in getting real time. Data:` + JSON.stringify(data));
+}).catch((error) => {
+ console.error(`Failed to get real time. Cause:` + JSON.stringify(error));
+});
+```
## systemTime.setDate
setDate(date: Date, callback: AsyncCallback<void>): void
-设置系统日期,使用callback形式返回结果。
+设置系统日期,使用callback异步回调。
**需要权限:** ohos.permission.SET_TIME
@@ -349,30 +338,29 @@ setDate(date: Date, callback: AsyncCallback<void>): void
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ------------------------- | ---- | ------------------------------------------ |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------- | ---- | --------------------- |
| date | Date | 是 | 目标日期。 |
-| callback | AsyncCallback<void> | 是 | 回调函数,可以在回调函数中处理接口返回值。 |
+| callback | AsyncCallback<void> | 是 | 回调函数。 |
**示例:**
- ```js
- var data = new Date();
- systemTime.setDate(data,(error, data) => {
- if (error) {
- console.error('failed to systemTime.setDate because ' + JSON.stringify(error));
- return;
- }
- console.info('systemTime.setDate success data : ' + JSON.stringify(data));
- });
- ```
-
+```js
+let data = new Date();
+systemTime.setDate(data,(error, data) => {
+ if (error) {
+ console.error('Failed to set system date. Cause:' + JSON.stringify(error));
+ return;
+}
+ console.info('Succeeded in setting system date. Data:' + JSON.stringify(data));
+});
+```
## systemTime.setDate
setDate(date: Date): Promise<void>
-设置系统日期,使用Promise形式返回结果。
+设置系统日期,使用Promise异步回调。
**需要权限:** ohos.permission.SET_TIME
@@ -388,52 +376,50 @@ setDate(date: Date): Promise<void>
| 类型 | 说明 |
| ------------------- | -------------------- |
-| Promise<void> | 返回的异步回调函数。 |
+| Promise<void> | 无返回结果的Promise对象。 |
**示例:**
- ```js
- var data = new Date();
- systemTime.setDate(data).then((value) => {
- console.log(`systemTime.setDate success data : ` + JSON.stringify(value));
- }).catch((error) => {
- console.error(`failed to systemTime.setDate because: ` + JSON.stringify(error));
- });
- ```
-
+```js
+let data = new Date();
+systemTime.setDate(data).then((value) => {
+ console.log(`Succeeded in setting system date. Data:` + JSON.stringify(value));
+}).catch((error) => {
+ console.error(`Failed to set system date. Cause:` + JSON.stringify(error));
+});
+```
## systemTime.getDate8+
getDate(callback: AsyncCallback<Date>): void
-获取当前系统日期,使用callback形式返回结果。
+获取当前系统日期,使用callback异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ------------------------- | ---- | ---------------------------- |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------- | ---- | --------------------- |
| callback | AsyncCallback<Date> | 是 | 回调函数,返回当前系统日期。 |
**示例:**
- ```js
- systemTime.getDate((error, data) => {
- if (error) {
- console.error(`failed to systemTime.getDate because ` + JSON.stringify(error));
- return;
- }
- console.log(`systemTime.getDate success data : ` + JSON.stringify(data));
- });
- ```
-
+```js
+systemTime.getDate((error, data) => {
+ if (error) {
+ console.error(`Failed to get system date. Cause:` + JSON.stringify(error));
+ return;
+ }
+ console.log(`Succeeded in getting system date. Data:` + JSON.stringify(data));
+});
+```
## systemTime.getDate8+
getDate(): Promise<Date>
-获取当前系统日期,使用Promise形式返回结果。
+获取当前系统日期,使用Promise异步回调。
**系统能力:** SystemCapability.MiscServices.Time
@@ -441,24 +427,23 @@ getDate(): Promise<Date>
| 类型 | 说明 |
| ------------------- | ----------------------------------------- |
-| Promise<Date> | 以Promise形式返回结果,返回当前系统日期。 |
+| Promise<Date> | Promise对象,返回当前系统日期。 |
**示例:**
- ```js
- systemTime.getDate().then((data) => {
- console.log(`systemTime.getDate success data : ` + JSON.stringify(data));
- }).catch((error) => {
- console.error(`failed to systemTime.getDate because ` + JSON.stringify(error));
- });
- ```
-
+```js
+systemTime.getDate().then((data) => {
+ console.log(`Succeeded in getting system date. Data:` + JSON.stringify(data));
+}).catch((error) => {
+ console.error(`Failed to get system date. Cause:` + JSON.stringify(error));
+});
+```
## systemTime.setTimezone
setTimezone(timezone: string, callback: AsyncCallback<void>): void
-设置系统时区。
+设置系统时区,使用callback异步回调。
**需要权限:** ohos.permission.SET_TIME_ZONE
@@ -466,29 +451,28 @@ setTimezone(timezone: string, callback: AsyncCallback<void>): void
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | ------------------------- | ---- | ------------------------------------------ |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------- | ---- | -------------------------- |
| timezone | string | 是 | 系统时区。 |
-| callback | AsyncCallback<void> | 是 | 回调函数,可以在回调函数中处理接口返回值。 |
+| callback | AsyncCallback<void> | 是 | 回调函数。 |
**示例:**
- ```js
- systemTime.setTimezone('Asia/Shanghai', (error, data) => {
- if (error) {
- console.error('failed to systemTime.setTimezone because ' + JSON.stringify(error));
- return;
- }
- console.info('SystemTimePlugin systemTime.setTimezone success data : ' + JSON.stringify(data));
- });
- ```
-
+```js
+systemTime.setTimezone('Asia/Shanghai', (error, data) => {
+ if (error) {
+ console.error('Failed to set system time zone. Cause:' + JSON.stringify(error));
+ return;
+ }
+ console.info('Succeeded in setting system time zone. Data:' + JSON.stringify(data));
+});
+```
## systemTime.setTimezone
setTimezone(timezone: string): Promise<void>
-设置系统时区。
+设置系统时区,使用Promise异步回调。
**需要权限:** ohos.permission.SET_TIME_ZONE
@@ -504,51 +488,49 @@ setTimezone(timezone: string): Promise<void>
| 类型 | 说明 |
| ------------------- | -------------------- |
-| Promise<void> | 返回的异步回调函数。 |
+| Promise<void> | 无返回结果的Promise对象。 |
**示例:**
- ```js
- systemTime.setTimezone('Asia/Shanghai').then((data) => {
- console.log(`systemTime.setTimezone success data : ` + JSON.stringify(data));
- }).catch((error) => {
- console.error(`failed to systemTime.setTimezone because: ` + JSON.stringify(error));
- });
- ```
-
+```js
+systemTime.setTimezone('Asia/Shanghai').then((data) => {
+ console.log(`Succeeded in setting system time zone. Data:` + JSON.stringify(data));
+}).catch((error) => {
+ console.error(`Failed to set system time zone. Cause:` + JSON.stringify(error));
+});
+```
## systemTime.getTimezone8+
getTimezone(callback: AsyncCallback<string>): void
-获取系统时区,使用callback形式返回结果。
+获取系统时区,使用callback异步回调。
**系统能力:** SystemCapability.MiscServices.Time
**参数:**
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | --------------------------- | ---- | ------------------------ |
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | --------- | ---- | ------------------------ |
| callback | AsyncCallback<string> | 是 | 回调函数,返回系统时区。 |
**示例:**
- ```js
- systemTime.getTimezone((error, data) => {
- if (error) {
- console.error(`failed to systemTime.getTimezone because ` + JSON.stringify(error));
- return;
- }
- console.log(`systemTime.getTimezone success data : ` + JSON.stringify(data));
- });
- ```
-
+```js
+systemTime.getTimezone((error, data) => {
+ if (error) {
+ console.error(`Failed to get system time zone. Cause:` + JSON.stringify(error));
+ return;
+ }
+ console.log(`Succeeded in getting system time zone. Data:` + JSON.stringify(data));
+});
+```
## systemTime.getTimezone8+
getTimezone(): Promise<string>
-获取系统时区,使用Promise形式返回结果。
+获取系统时区,使用Promise异步回调。
**系统能力:** SystemCapability.MiscServices.Time
@@ -556,14 +538,14 @@ getTimezone(): Promise<string>
| 类型 | 说明 |
| --------------------- | ------------------------------------- |
-| Promise<string> | 以Promise形式返回结果,返回系统时区。 |
+| Promise<string> | Promise对象,返回系统时区。 |
**示例:**
- ```js
- systemTime.getTimezone().then((data) => {
- console.log(`systemTime.getTimezone success data : ` + JSON.stringify(data));
- }).catch((error) => {
- console.error(`failed to systemTime.getTimezone because ` + JSON.stringify(error));
- });
- ```
\ No newline at end of file
+```js
+systemTime.getTimezone().then((data) => {
+ console.log(`Succeeded in getting system time zone. Data:` + JSON.stringify(data));
+}).catch((error) => {
+ console.error(`Failed to get system time zone. Cause:` + JSON.stringify(error));
+});
+```
\ No newline at end of file