HarmonyOS：获取系统时间及系统时区

最新推荐文章于 2025-06-23 18:00:00 发布

ChinaDragonDreamer

最新推荐文章于 2025-06-23 18:00:00 发布

阅读量1.7k

点赞数 15

CC 4.0 BY-SA版权

分类专栏： HarmonyOS 文章标签： harmonyos 鸿蒙

本文链接：https://blog.csdn.net/ChinaDragon10/article/details/145494277

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

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

一、导入模块

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

二、TimeType10+

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

系统能力: SystemCapability.MiscServices.Time

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

三、systemDateTime.getCurrentTime(deprecated)

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

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

说明
从API Version 12开始不再维护，建议使用systemDateTime.getTime10+替代。

系统能力： SystemCapability.MiscServices.Time

参数：

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

错误码：

以下错误码的详细介绍请参见时间时区错误码。

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

效果图

function testGetCurrentTime() {
  try {
    systemDateTime.getCurrentTime(false, (error: BusinessError, time: number) => {
      if (error) {
        console.info(`testGetCurrentTime 获取当前时间出错了. message: ${error.message}, code: ${error.code}`);
        return;
      }
      console.info(`testGetCurrentTime 获取当前时间成功 currentTime : ${time}`);
    })

  } catch (e) {
    let error = e as BusinessError;
    console.info(`testGetCurrentTime 获取当前时间发生异常 message: ${error.message}, code: ${error.code}`);
  }
}

function testGetTime() {
  try {
    let time = systemDateTime.getTime(false)
    console.info(`testGetTime 获取当前时间成功 currentTime : ${time}`);
  } catch (e) {
    let error = e as BusinessError;
    console.info(`testGetTime 获取当前时间发生异常 message: ${error.message}, code: ${error.code}`);
  }
}