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

最新推荐文章于 2025-04-11 10:13:21 发布
最新推荐文章于 2025-04-11 10:13:21 发布
阅读量1.4k 收藏 11
点赞数 15
分类专栏： HarmonyOS 文章标签： harmonyos 鸿蒙
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/ChinaDragon10/article/details/145494277
版权

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

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

一、导入模块

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

二、TimeType10+

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

系统能力: SystemCapability.MiscServices.Time

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

三、systemDateTime.getCurrentTime(deprecated)

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

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

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

系统能力： SystemCapability.MiscServices.Time

参数：

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

错误码：

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

错误码ID错误信息
401Parameter 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}`);
  }
}

四、systemDateTime.getCurrentTime(deprecated)

getCurrentTime(callback: AsyncCallback): void

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

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

系统能力： SystemCapability.MiscServices.Time

参数：

参数名类型必填说明
callbackAsyncCallback是回调函数，返回自Unix纪元以来经过的时间戳为毫秒数（ms）。

错误码：

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

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

效果图

在这里插入图片描述

function testGetCurrentTime2() {
  try {
    //回调函数，返回自Unix纪元以来经过的时间戳为毫秒数（ms）。
    systemDateTime.getCurrentTime((error: BusinessError, time: number) => {
      if (error) {
        console.info(`testGetCurrentTime2 获取当前时间出错了. message: ${error.message}, code: ${error.code}`);
        return;
      }
      console.info(`testGetCurrentTime2 获取当前时间成功 currentTime : ${time}`);
    });
  } catch(e) {
    let error = e as BusinessError;
    console.info(`testGetCurrentTime2 获取当前时间发生异常 message: ${error.message}, code: ${error.code}`);
  }
}

五、systemDateTime.getCurrentTime(deprecated)

getCurrentTime(isNano?: boolean): Promise

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

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

系统能力： SystemCapability.MiscServices.Time

参数：

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

返回值：

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

错误码：

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

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

效果图

在这里插入图片描述

function testGetCurrentTime3() {
  try {
    systemDateTime.getCurrentTime().then((time: number) => {
      console.info(`testGetCurrentTime3 获取当前时间成功 currentTime : ${time}`);
    }).catch((error: BusinessError) => {
      console.info(`testGetCurrentTime3  获取当前时间发生错误 message: ${error.message}, code: ${error.code}`);
    });
  } catch (e) {
    let error = e as BusinessError
    console.info(`testGetCurrentTime3 获取当前时间发生异常 message: ${error.message}, code: ${error.code}`);
  }
}

六、systemDateTime.getDate(deprecated)

getDate(callback: AsyncCallback): void

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

说明
从API version 9开始支持，从API 10开始废弃。建议使用new Date()替代，new Date()返回Date实例对象。

系统能力： SystemCapability.MiscServices.Time

参数：

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

错误码：

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

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

效果图

在这里插入图片描述

function testDate() {
  let date = new Date();
  console.info(`testDate 获取当前系统日期成功 date : ${date}`);
}

function testGetDate1() {
  try {
    systemDateTime.getDate((error: BusinessError, date: Date) => {
      if (error) {
        console.info(`testGetDate1 获取当前系统日期 发生错误 message: ${error.message}, code: ${error.code}`);
        return;
      }
      console.info(`testGetDate1 获取当前系统日期成功 date : ${date}`);
    });
  } catch (e) {
    let error = e as BusinessError;
    console.info(`testGetDate1 获取当前系统日期 发生异常 message: ${error.message}, code: ${error.code}`);
  }
}

七、systemDateTime.getDate(deprecated)

getDate(): Promise

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

说明
从API version 9开始支持，从API 10开始废弃。建议使用new Date()替代，new Date()返回Date实例对象。

系统能力： SystemCapability.MiscServices.Time

返回值：

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

错误码：

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

错误码ID错误信息
401Parameter error. Possible causes: 1.System error.
function testGetDate2() {
  try {
    systemDateTime.getDate().then((date: Date) => {
      console.info(`testGetDate2 获取当前系统日期成功 date : ${date}`);
    }).catch((error: BusinessError) => {
      console.info(`testGetDate2 获取当前系统日期 发生错误  message: ${error.message}, code: ${error.code}`);
    });
  } catch (e) {
    let error = e as BusinessError;
    console.info(`testGetDate2 获取当前系统日期 发生异常 message: ${error.message}, code: ${error.code}`);
  }
}

八、systemDateTime.getTimezone

getTimezone(callback: AsyncCallback): void

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

系统能力： SystemCapability.MiscServices.Time

参数：

参数名类型必填说明
allbackAsyncCallback<string>是回调函数，返回系统时区。具体可见支持的系统时区 。

效果图

在这里插入图片描述

function testGetTimezone1() {
  try {
    systemDateTime.getTimezone((error: BusinessError, data: string) => {
      if (error) {
        console.info(`testGetTimezone1 获取系统时区 发生错误 message: ${error.message}, code: ${error.code}`);
        return;
      }
      console.info(`testGetTimezone1 获取系统时区 成功 timezone : ${data}`);
    });
  } catch (e) {
    let error = e as BusinessError;
    console.info(`testGetTimezone1 获取系统时区 发生异常 message: ${error.message}, code: ${error.code}`);
  }
}

九、systemDateTime.getTimezone

getTimezone(): Promise

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

系统能力： SystemCapability.MiscServices.Time

返回值：

类型说明
Promise<string>Promise对象，返回系统时区。具体可见支持的系统时区 。
function testGetTimezone2() {
  try {
    systemDateTime.getTimezone().then((data: string) => {
      console.info(`testGetTimezone2 获取系统时区 成功 timezone : ${data}`);
    }).catch((error: BusinessError) => {
      console.info(`testGetTimezone2 获取系统时区 发生错误 message: ${error.message}, code: ${error.code}`);
    });
  } catch (e) {
    let error = e as BusinessError;
    console.info(`testGetTimezone2 获取系统时区 发生异常 message: ${error.message}, code: ${error.code}`);
  }
}

十、systemDateTime.getTimezoneSync10+

getTimezoneSync(): string

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

系统能力： SystemCapability.MiscServices.Time

返回值：

类型说明
string返回系统时区。具体可见支持的系统时区 。

效果图

在这里插入图片描述

function testGetTimezoneSync() {
  try {
    let timezone = systemDateTime.getTimezoneSync();
    console.info(`testGetTimezoneSync  获取系统时区 成功 timezone: ${timezone}`);
  } catch (e) {
    let error = e as BusinessError;
    console.info(`testGetTimezoneSync 获取系统时区 发生异常 message: ${error.message}, code: ${error.code}`);
  }
}

十一、支持的系统时区

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

时区偏移量
Antarctica/McMurdo 12
America/Argentina/Buenos_Aires-3
Australia/Sydney10
America/Noronha-2
America/St_Johns-3
Africa/Kinshasa1
America/Santiago-3
Asia/Shanghai8
Asia/Nicosia3
Europe/Berlin2
America/Guayaquil-5
Europe/Madrid2
Pacific/Pohnpei11
America/Godthab-2
Asia/Jakarta7
Pacific/Tarawa12
Asia/Almaty6
Pacific/Majuro12
Asia/Ulaanbaatar8
America/Mexico_City-5
Asia/Kuala_Lumpur8
Pacific/Auckland12
Pacific/Tahiti-10
Pacific/Port_Moresby10
Asia/Gaza3
Europe/Lisbon1
Europe/Moscow3
Europe/Kiev3
Pacific/Wake12
America/New_York-4
Asia/Tashkent5
OpenHarmony/HarmonyOS如何获取系统时间戳
坚果的博客
07-08 1万+
润开鸿生态技术专家，华为HDE，InfoQ签约作者，OpenHarmony布道师，擅长HarmonyOS应用开发、熟悉服务卡片开发，在“战码先锋”活动中作为大队长，累计培养三个小队长，带领100+队员完成Pr的提交合入。在HarmonyOS中使用接口@ohos.systemDateTime的getCurrentTime来获取系统系统时间和时区。欢迎通过主页或者私信联系我，加入坚果派，一起学习鸿蒙应用开发。适用于：Harmony 3.1 Release API 9。公众号：“大前端之旅”
HarmonyOS APP开发入门3——组件（六 时间组件 ）---Clock，TickTimer，TimePicker
itcyy的博客
04-12 2417
HarmonyOS APP开发入门3——组件（六 时间组件 ）—Clock，TickTimer，TimePicker 文章目录HarmonyOS APP开发入门3——组件（六 时间组件 ）---Clock，TickTimer，TimePicker前言Clock时钟组件TickTimer定时器组件TimePicker组件 前言 大家好，本章是鸿蒙开发的重头戏，时间组件 Clock时钟组件 组件说明 是Text的子类，所以可以使用Text的一些属性。 常用属性 **属性名称 ** 功能说明 ti
鸿蒙开发系统基础能力：【@ohos.systemTime (设置系统时间)】
2301_76813281的博客
06-26 1638
本模块用来设置、获取当前系统时间，设置、获取当前系统日期和设置、获取当前系统时区。本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
鸿蒙开发实现获取系统时间
最新发布
afufufufu的博客
04-11 182
【代码】鸿蒙开发实现获取系统时间。
鸿蒙开发之获取系统时间
Lu_Ca的博客
12-28 4233
1、获取自Unix纪元以来的纳秒，第一个参数true表示纳秒，false表示毫秒。注意：所有API在预览器不生效，需要在模拟器或真机测试。2、获取自系统启动的毫秒数，不包括深度睡眠的时间。3、获取系统启动的毫秒数，包括深度睡眠的时间。4、获取当前系统的日期。5、获取当前系统的时区。
鸿蒙开发-OpenHarmony轻量系统之获取当地时间
鸿蒙的技术博客
01-22 3024
SNTP(Simple Network Time Protocal简单网络时间协议)，用于跨广域网或局域网同步时间的协议，主要用来同步因特网中的计算机时钟，具有较高的精确度（几十毫秒）。SNTP协议相对于NTP，优化了网络传播延时的影响，同时也能保证时间达到一定的精确度。SNTP协议采用客户端/服务器的工作方式，可以采用单播（点对点）或者广播（一点对多点）模式操作。SNTP服务器通过接收 GPS信号或自带的原子钟作为系统的时间基准。
获取当前系统的时间
weixin_34220179的博客
07-27 588
import java.util.Date;import java.text.SimpleDateFormat; public class NowString {public static void main(String[] args) {　　SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");//设置日期格式　...
获取当前系统时间（三种方法）
fuerbosi
07-09 6161
#include&lt;time.h&gt; #include&lt;stdio.h&gt; void main() { /*方法1time_t curTime = time(NULL);char* curDate = ctime(&amp;curTime);printf(curDate);-----------------------|通过给time()传递NULL参数获取当前日期和时间|...
【Harmony OS】【ARK UI】Date 基本操作
华为开发者联盟
08-02 2006
Date 基本操作
鸿蒙 HarmonyOS Linux 镜像定制实战：创建个性化操作系统（镜像定制指南）
[鸿蒙 HarmonyOS Linux 系统镜像](https://imgo3.hackhome.com/img2020/11/26/10/544499361.jpg) 参考资源链接：[鸿蒙HarmonyOS Linux系统镜像ISO与VMware使用教程]...
HarmonyOS应用开发-显示时间的实现
weixin_69135651的博客
04-23 1982
创建项目 示例代码 hml： <div class="container"> <text class="title">现在的时间是:</text> <text class="title">{{ year }}年{{ mouth }}月{{ day }}日</text> <text class="title">{{ hour }}:{{min}}</text> </di...
获取当前系统时间
CJF0410的博客
12-16 503
java代码： import java.text.SimpleDateFormat;SimpleDateFormat formatter = new SimpleDateFormat (“yyyy年MM月dd日 HH:mm:ss “); Date curDate = new Date(System.currentTimeMillis());//获取当前时间 String str = forma
获取系统当前时间
pzy的专栏
08-13 580
在调试、日志输出、代码优化时，我们常常需要获得系统的时间。在一些性能要求高的代码优化时，对时间的精确度还比较高。在网上找不高质量的代码，便自己研究了一下，代码如下(能满足跨平台的要求，单位精确到微秒)： #ifdef _WIN32 #include <windows.h> #else #include <time.h> #endif // _WIND32 // 定义64位整形 #if defined(_WIN32) && !defined(CYGWIN)..
获取当前系统的时间(简单明了)
qq_44303639的博客
07-19 502
获取当前系统的时间 @Test public void test (){ //获取当前的日期 Date date =new Date(); System.out.println(date);//当前系统时间 DateFormat dateFormat=new SimpleDateFormat("yyyy-MM-dd"); //指定时间的格式 String date1= dateFormat.for
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值