本模块主要由系统时间和系统时区功能组成。开发者可以获取系统时间及系统时区。

说明

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

## 导入模块

PhonePC/2in1TabletTVWearable



```
1. import { systemDateTime } from '@kit.BasicServicesKit';
```

## TimeType10+

PhonePC/2in1TabletTVWearable

定义获取时间的枚举类型。

**系统能力**: SystemCapability.MiscServices.Time

展开

| 名称 | 值 | 说明 |
| --- | --- | --- |
| STARTUP | 0 | 自系统启动以来经过的毫秒数，包括深度睡眠时间。 |
| ACTIVE | 1 | 自系统启动以来经过的毫秒数，不包括深度睡眠时间。 |

## systemDateTime.getCurrentTime(deprecated)

PhonePC/2in1TabletTVWearable

getCurrentTime(isNano: boolean, callback: AsyncCallback<number>): void

获取自Unix纪元以来经过的时间，使用callback异步回调。

说明

从API version 9开始支持，从API version 12开始废弃，建议使用[systemDateTime.getTime10+](/consumer/cn/doc/harmonyos-references/js-apis-date-time#systemdatetimegettime10)替代。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| isNano | boolean | 是 | 返回结果是否为纳秒数。  - true：表示返回结果为纳秒数（ns）。  - false：表示返回结果为毫秒数（ms）。 |
| callback | AsyncCallback<number> | 是 | 回调函数，返回自Unix纪元以来经过的时间戳。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getCurrentTime(true, (error: BusinessError, time: number) => {
5. if (error) {
6. console.error(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
7. return;
8. }
9. console.info(`Succeeded in getting currentTime : ${time}`);
10. });
11. } catch(e) {
12. let error = e as BusinessError;
13. console.error(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
14. }
```

## systemDateTime.getCurrentTime(deprecated)

PhonePC/2in1TabletTVWearable

getCurrentTime(callback: AsyncCallback<number>): void

获取自Unix纪元以来经过的时间，使用callback异步回调。

说明

从API version 9开始支持，从API version 12开始废弃，建议使用[systemDateTime.getTime10+](/consumer/cn/doc/harmonyos-references/js-apis-date-time#systemdatetimegettime10)替代。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| callback | AsyncCallback<number> | 是 | 回调函数，返回自Unix纪元以来经过的时间戳（ms）。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getCurrentTime((error: BusinessError, time: number) => {
5. if (error) {
6. console.error(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
7. return;
8. }
9. console.info(`Succeeded in getting currentTime : ${time}`);
10. });
11. } catch(e) {
12. let error = e as BusinessError;
13. console.error(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
14. }
```

## systemDateTime.getCurrentTime(deprecated)

PhonePC/2in1TabletTVWearable

getCurrentTime(isNano?: boolean): Promise<number>

获取自Unix纪元以来经过的时间，使用Promise异步回调。

说明

从API version 9开始支持，从API version 12开始废弃，建议使用[systemDateTime.getTime10+](/consumer/cn/doc/harmonyos-references/js-apis-date-time#systemdatetimegettime10)替代。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| isNano | boolean | 否 | 返回结果是否为纳秒数,默认值为false。  - true：表示返回结果为纳秒数（ns）。  - false：表示返回结果为毫秒数（ms）。 |

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| Promise<number> | Promise对象，返回自Unix纪元以来经过的时间戳。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getCurrentTime().then((time: number) => {
5. console.info(`Succeeded in getting currentTime : ${time}`);
6. }).catch((error: BusinessError) => {
7. console.error(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
8. });
9. } catch(e) {
10. let error = e as BusinessError;
11. console.error(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
12. }
```

## systemDateTime.getRealActiveTime(deprecated)

PhonePC/2in1TabletTVWearable

getRealActiveTime(isNano: boolean, callback: AsyncCallback<number>): void

获取自系统启动以来经过的时间，不包括深度睡眠时间，使用callback异步回调。

说明

从API version 9开始支持，从API version 12开始废弃，建议使用[systemDateTime.getUptime10+](/consumer/cn/doc/harmonyos-references/js-apis-date-time#systemdatetimegetuptime10)替代。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| isNano | boolean | 是 | 返回结果是否为纳秒数。  - true：表示返回结果为纳秒数（ns）。  - false：表示返回结果为毫秒数（ms）。 |
| callback | AsyncCallback<number> | 是 | 回调函数，返回自系统启动以来经过的时间，但不包括深度睡眠时间。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getRealActiveTime(true, (error: BusinessError, time: number) => {
5. if (error) {
6. console.error(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
7. return;
8. }
9. console.info(`Succeeded in getting real active time : ${time}`);
10. });
11. } catch(e) {
12. let error = e as BusinessError;
13. console.error(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
14. }
```

## systemDateTime.getRealActiveTime(deprecated)

PhonePC/2in1TabletTVWearable

getRealActiveTime(callback: AsyncCallback<number>): void

获取自系统启动以来经过的时间，不包括深度睡眠时间，使用callback异步回调。

说明

从API version 9开始支持，从API version 12开始废弃，建议使用[systemDateTime.getUptime10+](/consumer/cn/doc/harmonyos-references/js-apis-date-time#systemdatetimegetuptime10)替代。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| callback | AsyncCallback<number> | 是 | 回调函数，返回自系统启动以来经过的时间（ms），但不包括深度睡眠时间。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getRealActiveTime((error: BusinessError, time: number) => {
5. if (error) {
6. console.error(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
7. return;
8. }
9. console.info(`Succeeded in getting real active time : ${time}`);
10. });
11. } catch(e) {
12. let error = e as BusinessError;
13. console.error(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
14. }
```

## systemDateTime.getRealActiveTime(deprecated)

PhonePC/2in1TabletTVWearable

getRealActiveTime(isNano?: boolean): Promise<number>

获取自系统启动以来经过的时间，不包括深度睡眠时间，使用Promise异步回调。

说明

从API version 9开始支持，从API version 12开始废弃，建议使用[systemDateTime.getUptime10+](/consumer/cn/doc/harmonyos-references/js-apis-date-time#systemdatetimegetuptime10)替代。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| isNano | boolean | 否 | 返回结果是否为纳秒数,默认值为false。  - true：表示返回结果为纳秒数（ns）。  - false：表示返回结果为毫秒数（ms）。 |

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| Promise<number> | Promise对象，返回自系统启动以来经过的时间，但不包括深度睡眠时间。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getRealActiveTime().then((time: number) => {
5. console.info(`Succeeded in getting real active time : ${time}`);
6. }).catch((error: BusinessError) => {
7. console.error(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
8. });
9. } catch(e) {
10. let error = e as BusinessError;
11. console.error(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
12. }
```

## systemDateTime.getRealTime(deprecated)

PhonePC/2in1TabletTVWearable

getRealTime(isNano: boolean, callback: AsyncCallback<number>): void

获取自系统启动以来经过的时间，包括深度睡眠时间，使用callback异步回调。

说明

从API version 9开始支持，从API version 12开始废弃，建议使用[systemDateTime.getUptime10+](/consumer/cn/doc/harmonyos-references/js-apis-date-time#systemdatetimegetuptime10)替代。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| isNano | boolean | 是 | 返回结果是否为纳秒数。  - true：表示返回结果为纳秒数（ns）。  - false：表示返回结果为毫秒数（ms）。 |
| callback | AsyncCallback<number> | 是 | 回调函数，返回自系统启动以来经过的时间，包括深度睡眠时间。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getRealTime(true, (error: BusinessError, time: number) => {
5. if (error) {
6. console.error(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
7. return;
8. }
9. console.info(`Succeeded in getting real time : ${time}`);
10. });
11. } catch(e) {
12. let error = e as BusinessError;
13. console.error(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
14. }
```

## systemDateTime.getRealTime(deprecated)

PhonePC/2in1TabletTVWearable

getRealTime(callback: AsyncCallback<number>): void

获取自系统启动以来经过的时间，包括深度睡眠时间，使用callback异步回调。

说明

从API version 9开始支持，从API version 12开始废弃，建议使用[systemDateTime.getUptime10+](/consumer/cn/doc/harmonyos-references/js-apis-date-time#systemdatetimegetuptime10)替代。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| callback | AsyncCallback<number> | 是 | 回调函数，返回自系统启动以来经过的时间（ms），包括深度睡眠时间。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getRealTime((error: BusinessError, time: number) => {
5. if (error) {
6. console.error(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
7. return;
8. }
9. console.info(`Succeeded in getting real time : ${time}`);
10. });
11. } catch(e) {
12. let error = e as BusinessError;
13. console.error(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
14. }
```

## systemDateTime.getRealTime(deprecated)

PhonePC/2in1TabletTVWearable

getRealTime(isNano?: boolean): Promise<number>

获取自系统启动以来经过的时间，包括深度睡眠时间，使用Promise异步回调。

说明

从API version 9开始支持，从API version 12开始废弃，建议使用[systemDateTime.getUptime10+](/consumer/cn/doc/harmonyos-references/js-apis-date-time#systemdatetimegetuptime10)替代。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| isNano | boolean | 否 | 返回结果是否为纳秒数,默认值为false。  - true：表示返回结果为纳秒数（ns）。  - false：表示返回结果为毫秒数（ms）。 |

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| Promise<number> | Promise对象，返回自系统启动以来经过的时间，包括深度睡眠时间。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getRealTime().then((time: number) => {
5. console.info(`Succeeded in getting real time : ${time}`);
6. }).catch((error: BusinessError) => {
7. console.error(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
8. });
9. } catch(e) {
10. let error = e as BusinessError;
11. console.error(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
12. }
```

## systemDateTime.getTime10+

PhonePC/2in1TabletTVWearable

getTime(isNanoseconds?: boolean): number

使用同步方式获取自Unix纪元以来到当前系统时间所经过的时间。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| isNanoseconds | boolean | 否 | 返回结果是否为纳秒数。  - true：表示返回结果为纳秒数（ns）。  - false：表示返回结果为毫秒数（ms）。  默认值为false。 |

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| number | 自Unix纪元以来到当前系统时间所经过的时间。 |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. let time: number = systemDateTime.getTime(true)
5. } catch(e) {
6. let error = e as BusinessError;
7. console.error(`Failed to get time. message: ${error.message}, code: ${error.code}`);
8. }
```

## systemDateTime.getUptime10+

PhonePC/2in1TabletTVWearable

getUptime(timeType: TimeType, isNanoseconds?: boolean): number

使用同步方式获取自系统启动以来经过的时间。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| timeType | [TimeType](/consumer/cn/doc/harmonyos-references/js-apis-date-time#timetype10) | 是 | 获取时间的类型，仅能为STARTUP或者ACTIVE。 |
| isNanoseconds | boolean | 否 | 返回结果是否为纳秒数。  - true：表示返回结果为纳秒数（ns）。  - false：表示返回结果为毫秒数（ms）。  默认值为false。 |

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| number | 自系统启动以来经过的时间。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification  failed.This error code was added due to missing issues. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. let time: number = systemDateTime.getUptime(systemDateTime.TimeType.ACTIVE, false);
5. } catch(e) {
6. let error = e as BusinessError;
7. console.error(`Failed to get uptime. message: ${error.message}, code: ${error.code}`);
8. }
```

## systemDateTime.getDate(deprecated)

PhonePC/2in1TabletTVWearable

getDate(callback: AsyncCallback<Date>): void

获取当前系统日期，使用callback异步回调。

说明

从API version 9开始支持，从API version 10开始废弃，建议使用[如何将时间格式的字符串string转换为Date对象](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/faqs/faqs-arkui-arkts.md#如何将时间格式的字符串string转换为date对象api-9)中的new Date()方法替代，new Date()返回Date实例对象。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| callback | AsyncCallback<Date> | 是 | 回调函数，返回当前系统日期。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.System error. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getDate((error: BusinessError, date: Date) => {
5. if (error) {
6. console.error(`Failed to get date. message: ${error.message}, code: ${error.code}`);
7. return;
8. }
9. console.info(`Succeeded in getting date : ${date}`);
10. });
11. } catch(e) {
12. let error = e as BusinessError;
13. console.error(`Failed to get date. message: ${error.message}, code: ${error.code}`);
14. }
```

## systemDateTime.getDate(deprecated)

PhonePC/2in1TabletTVWearable

getDate(): Promise<Date>

获取当前系统日期，使用Promise异步回调。

说明

从API version 9开始支持，从API version 10开始废弃，建议使用[如何将时间格式的字符串string转换为Date对象](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/faqs/faqs-arkui-arkts.md#如何将时间格式的字符串string转换为date对象api-9)中的new Date()方法替代，new Date()返回Date实例对象。

**系统能力：** SystemCapability.MiscServices.Time

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| Promise<Date> | Promise对象，返回当前系统日期。 |

**错误码：**

以下错误码的详细介绍请参见[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Parameter error. Possible causes: 1.System error. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getDate().then((date: Date) => {
5. console.info(`Succeeded in getting date : ${date}`);
6. }).catch((error: BusinessError) => {
7. console.error(`Failed to get date. message: ${error.message}, code: ${error.code}`);
8. });
9. } catch(e) {
10. let error = e as BusinessError;
11. console.error(`Failed to get date. message: ${error.message}, code: ${error.code}`);
12. }
```

## systemDateTime.getTimezone

PhonePC/2in1TabletTVWearable

getTimezone(callback: AsyncCallback<string>): void

获取系统时区，使用callback异步回调。

**系统能力：** SystemCapability.MiscServices.Time

**参数：**

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| callback | AsyncCallback<string> | 是 | 回调函数，返回系统时区。具体可见[支持的系统时区](/consumer/cn/doc/harmonyos-references/js-apis-date-time#支持的系统时区)。 |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getTimezone((error: BusinessError, data: string) => {
5. if (error) {
6. console.error(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
7. return;
8. }
9. console.info(`Succeeded in get timezone : ${data}`);
10. });
11. } catch(e) {
12. let error = e as BusinessError;
13. console.error(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
14. }
```

## systemDateTime.getTimezone

PhonePC/2in1TabletTVWearable

getTimezone(): Promise<string>

获取系统时区，使用Promise异步回调。

**系统能力：** SystemCapability.MiscServices.Time

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| Promise<string> | Promise对象，返回系统时区。具体可见[支持的系统时区](/consumer/cn/doc/harmonyos-references/js-apis-date-time#支持的系统时区)。 |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. systemDateTime.getTimezone().then((data: string) => {
5. console.info(`Succeeded in getting timezone: ${data}`);
6. }).catch((error: BusinessError) => {
7. console.error(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
8. });
9. } catch(e) {
10. let error = e as BusinessError;
11. console.error(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
12. }
```

## systemDateTime.getTimezoneSync10+

PhonePC/2in1TabletTVWearable

getTimezoneSync(): string

获取系统时区，使用同步方式。

**系统能力：** SystemCapability.MiscServices.Time

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| string | 返回系统时区。具体可见[支持的系统时区](/consumer/cn/doc/harmonyos-references/js-apis-date-time#支持的系统时区)。 |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. let timezone: string = systemDateTime.getTimezoneSync();
5. } catch(e) {
6. let error = e as BusinessError;
7. console.error(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
8. }
```

## 支持的系统时区

PhonePC/2in1TabletTVWearable

支持的系统时区及各时区与0时区相比的偏移量(单位：h)可见下表。

展开

| 时区 | 偏移量 |
| --- | --- |
| Antarctica/McMurdo | 12 |
| America/Argentina/Buenos\_Aires | -3 |
| Australia/Sydney | 10 |
| America/Noronha | -2 |
| America/St\_Johns | -3 |
| Africa/Kinshasa | 1 |
| America/Santiago | -3 |
| Asia/Shanghai | 8 |
| Asia/Nicosia | 3 |
| Europe/Berlin | 2 |
| America/Guayaquil | -5 |
| Europe/Madrid | 2 |
| Pacific/Pohnpei | 11 |
| America/Godthab | -2 |
| Asia/Jakarta | 7 |
| Pacific/Tarawa | 12 |
| Asia/Almaty | 6 |
| Pacific/Majuro | 12 |
| Asia/Ulaanbaatar | 8 |
| America/Mexico\_City | -5 |
| Asia/Kuala\_Lumpur | 8 |
| Pacific/Auckland | 12 |
| Pacific/Tahiti | -10 |
| Pacific/Port\_Moresby | 10 |
| Asia/Gaza | 3 |
| Europe/Lisbon | 1 |
| Europe/Moscow | 3 |
| Europe/Kiev | 3 |
| Pacific/Wake | 12 |
| America/New\_York | -4 |
| Asia/Tashkent | 5 |

## systemDateTime.getAutoTimeStatus21+

PhonePC/2in1TabletTVWearable

getAutoTimeStatus(): boolean

获取自动设置时间开关状态，使用同步方式。

**系统能力：** SystemCapability.MiscServices.Time

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| boolean | 返回自动设置时间开关状态。  - true：表示自动设置时间开关状态为打开。  - false：表示自动设置时间开关状态为关闭。 |

**错误码：**

以下错误码的详细介绍请参见[时间时区服务错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-time)和[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 13000001 | Network connection error or OS error. Possible causes: 1.System memory is insufficient; 2.Calls the underlying system interface failed. |

**示例：**



```
1. import { BusinessError } from '@kit.BasicServicesKit';

3. try {
4. let status: boolean = systemDateTime.getAutoTimeStatus();
5. } catch(e) {
6. let error = e as BusinessError;
7. console.error(`Failed to get autotime status. message: ${error.message}, code: ${error.code}`);
8. }
```