系统时间、时区

2024-01-23 17:26 更新

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

说明

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

导入模块

  1. import systemDateTime from '@ohos.systemDateTime';

systemDateTime.getCurrentTime

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

isNano

boolean

返回结果是否为纳秒数。

- true:表示返回结果为纳秒数(ns)。

- false:表示返回结果为毫秒数(ms)。

callback

AsyncCallback<number>

回调函数,返回自Unix纪元以来经过的时间。

示例:

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

systemDateTime.getCurrentTime

getCurrentTime(callback: AsyncCallback<number>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

callback

AsyncCallback<number>

回调函数,返回自Unix纪元以来经过的时间戳(ms)。

示例:

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

systemDateTime.getCurrentTime

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

isNano

boolean

返回结果是否为纳秒数。

- true:表示返回结果为纳秒数(ns)。

- false:表示返回结果为毫秒数(ms)。

返回值:

类型

说明

Promise<number>

Promise对象,返回自Unix纪元以来经过的时间戳。

示例:

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

systemDateTime.getRealActiveTime

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

isNano

boolean

返回结果是否为纳秒数。

- true:表示返回结果为纳秒数(ns)。

- false:表示返回结果为毫秒数(ms)。

callback

AsyncCallback<number>

回调函数,返回自系统启动以来经过的时间,但不包括深度睡眠时间。

示例:

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

systemDateTime.getRealActiveTime

getRealActiveTime(callback: AsyncCallback<number>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

callback

AsyncCallback<number>

回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。

示例:

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

systemDateTime.getRealActiveTime

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

isNano

boolean

返回结果是否为纳秒数。

- true:表示返回结果为纳秒数(ns)。

- false:表示返回结果为毫秒数(ms)。

返回值:

类型

说明

Promise<number>

Promise对象,返回自系统启动以来经过的时间,但不包括深度睡眠时间。

示例:

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

systemDateTime.getRealTime

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

isNano

boolean

返回结果是否为纳秒数。

- true:表示返回结果为纳秒数(ns)。

- false:表示返回结果为毫秒数(ms)。

callback

AsyncCallback<number>

回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。

示例:

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

systemDateTime.getRealTime

getRealTime(callback: AsyncCallback<number>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

callback

AsyncCallback<number>

回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。

示例:

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

systemDateTime.getRealTime

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

isNano

boolean

返回结果是否为纳秒数。

- true:表示返回结果为纳秒数(ns)。

- false:表示返回结果为毫秒数(ms)。

返回值:

类型

说明

Promise<number>

Promise对象,返回自系统启动以来经过的时间,包括深度睡眠时间。

示例:

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

systemDateTime.getDate

getDate(callback: AsyncCallback<Date>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

callback

AsyncCallback<Date>

回调函数,返回当前系统日期。

示例:

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

systemDateTime.getDate

getDate(): Promise<Date>

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

系统能力: SystemCapability.MiscServices.Time

返回值:

类型

说明

Promise<Date>

Promise对象,返回当前系统日期。

示例:

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

systemDateTime.getTimezone

getTimezone(callback: AsyncCallback<string>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名

类型

必填

说明

callback

AsyncCallback<string>

回调函数,返回系统时区。具体可见支持的系统时区 。

示例:

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

systemDateTime.getTimezone

getTimezone(): Promise<string>

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

系统能力: SystemCapability.MiscServices.Time

返回值:

类型

说明

Promise<string>

Promise对象,返回系统时区。具体可见支持的系统时区 。

示例:

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

支持的系统时区

支持的系统时区及各时区与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

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号