openharmony 鸿蒙 js-apis-system-time

2025-06-12 浏览 (1)

@ohos.systemTime (系统时间、时区)

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

说明:

  • 从API Version 9 开始,该模块接口不再维护,推荐使用新模块接口@ohos.systemDateTime (系统时间、时区)
  • 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

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

systemTime.getCurrentTime8+(deprecated)

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

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

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getCurrentTime(true, (error: BusinessError, time: number) => {
    if (error) {
      console.info(`Failed to getting currentTime. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in getting currentTime: ${time}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
}

systemTime.getCurrentTime8+(deprecated)

getCurrentTime(callback: AsyncCallback<number>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
callbackAsyncCallback<number>回调函数,返回自Unix纪元以来经过的时间。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getCurrentTime((error: BusinessError, time: number) => {
    if (error) {
      console.info(`Failed to getting currentTime. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in getting currentTime : ${time}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
}

systemTime.getCurrentTime8+(deprecated)

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

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

返回值:

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

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getCurrentTime().then((time: number) => {
    console.info(`Succeeded in getting currentTime : ${time}`);
  }).catch((error: BusinessError) => {
    console.info(`Failed to getting currentTime. message: ${error.message}, code: ${error.code}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
}

systemTime.getRealActiveTime8+(deprecated)

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
isNanoboolean返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。
callbackAsyncCallback<number>回调函数,返回自系统启动以来经过的时间,不包括深度睡眠时间。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getRealActiveTime(true, (error: BusinessError, time: number) => {
    if (error) {
      console.info(`Failed to getting real active time. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in getting real active time : ${time}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
}

systemTime.getRealActiveTime8+(deprecated)

getRealActiveTime(callback: AsyncCallback<number>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
callbackAsyncCallback<number>回调函数,返回自系统启动以来经过的时间,不包括深度睡眠时间。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getRealActiveTime((error: BusinessError, time: number) => {
    if (error) {
      console.info(`Failed to getting real active time. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in getting real active time : ${time}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
}

systemTime.getRealActiveTime8+(deprecated)

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

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

返回值:

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

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getRealActiveTime().then((time: number) => {
    console.info(`Succeeded in getting real active time : ${time}`);
  }).catch((error: BusinessError) => {
    console.info(`Failed to getting real active time. message: ${error.message}, code: ${error.code}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
}

systemTime.getRealTime8+(deprecated)

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
isNanoboolean返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。
callbackAsyncCallback<number>回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getRealTime(true, (error: BusinessError, time: number) => {
    if (error) {
      console.info(`Failed to getting real time. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in getting real time : ${time}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
}

systemTime.getRealTime8+(deprecated)

getRealTime(callback: AsyncCallback<number>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
callbackAsyncCallback<number>回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getRealTime((error: BusinessError, time: number) => {
    if (error) {
      console.info(`Failed to getting real time. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in getting real time : ${time}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
}

systemTime.getRealTime8+(deprecated)

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

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

系统能力: SystemCapability.MiscServices.Time

参数:

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

返回值:

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

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getRealTime().then((time: number) => {
    console.info(`Succeeded in getting real time : ${time}`);
  }).catch((error: BusinessError) => {
    console.info(`Failed to getting real time. message: ${error.message}, code: ${error.code}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
}

systemTime.getDate8+(deprecated)

getDate(callback: AsyncCallback<Date>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

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

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getDate((error: BusinessError, date: Date) => {
    if (error) {
      console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in get date : ${date}`);;
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`);
}

systemTime.getDate8+(deprecated)

getDate(): Promise<Date>

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

系统能力: SystemCapability.MiscServices.Time

返回值:

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

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getDate().then((date: Date) => {
    console.info(`Succeeded in getting date : ${date}`);
  }).catch((error: BusinessError) => {
    console.info(`Failed to getting date. message: ${error.message}, code: ${error.code}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`);
}

systemTime.getTimezone8+(deprecated)

getTimezone(callback: AsyncCallback<string>): void

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

系统能力: SystemCapability.MiscServices.Time

参数:

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

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getTimezone((error: BusinessError, data: string) => {
    if (error) {
      console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in get timezone : ${data}`);;
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
}

systemTime.getTimezone8+(deprecated)

getTimezone(): Promise<string>

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

系统能力: SystemCapability.MiscServices.Time

返回值:

类型说明
Promise<string>Promise对象,返回系统时区。具体可见支持的系统时区

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.getTimezone().then((data: string) => {
    console.info(`Succeeded in getting timezone: ${data}`);
  }).catch((error: BusinessError) => {
    console.info(`Failed to getting timezone. message: ${error.message}, code: ${error.code}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
}

systemTime.setTime(deprecated)

setTime(time : number, callback : AsyncCallback<void>) : void

设置系统时间,使用callback异步回调。

需要权限: ohos.permission.SET_TIME

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
timenumber目标时间戳(ms)。
callbackAsyncCallback<void>回调函数。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

// time对应的时间为2021-01-20 02:36:25
let time = 1611081385000;
try {
  systemTime.setTime(time, (error: BusinessError) => {
    if (error) {
      console.info(`Failed to setting time. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in setting time`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to set time. message: ${error.message}, code: ${error.code}`);
}

systemTime.setTime(deprecated)

setTime(time : number) : Promise<void>

设置系统时间,使用Promise异步回调。

需要权限: ohos.permission.SET_TIME

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
timenumber目标时间戳(ms)。

返回值:

类型说明
Promise<void>无返回结果的Promise对象。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

// time对应的时间为2021-01-20 02:36:25
let time = 1611081385000;
try {
  systemTime.setTime(time).then(() => {
    console.info(`Succeeded in setting time.`);
  }).catch((error: BusinessError) => {
    console.info(`Failed to setting time. message: ${error.message}, code: ${error.code}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to set time. message: ${error.message}, code: ${error.code}`);
}

systemTime.setDate(deprecated)

setDate(date: Date, callback: AsyncCallback<void>): void

设置系统日期,使用callback异步回调。

需要权限: ohos.permission.SET_TIME

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
dateDate目标日期。
callbackAsyncCallback<void>回调函数。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

let date = new Date();
try {
  systemTime.setDate(date, (error: BusinessError) => {
    if (error) {
      console.info(`Failed to setting date. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in setting date.`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to set date. message: ${error.message}, code: ${error.code}`);
}

systemTime.setDate(deprecated)

setDate(date: Date): Promise<void>

设置系统日期,使用Promise异步回调。

需要权限: ohos.permission.SET_TIME

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
dateDate目标日期。

返回值:

类型说明
Promise<void>无返回结果的Promise对象。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

let date = new Date(); 
try {
  systemTime.setDate(date).then(() => {
    console.info(`Succeeded in setting date.`);
  }).catch((error: BusinessError) => {
    console.info(`Failed to setting date. message: ${error.message}, code: ${error.code}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to set date. message: ${error.message}, code: ${error.code}`);
}

systemTime.setTimezone(deprecated)

setTimezone(timezone: string, callback: AsyncCallback<void>): void

设置系统时区,使用callback异步回调。

需要权限: ohos.permission.SET_TIME_ZONE

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
timezonestring系统时区。具体可见支持的系统时区
callbackAsyncCallback<void>回调函数。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.setTimezone('Asia/Shanghai', (error: BusinessError) => {
    if (error) {
      console.info(`Failed to setting timezone. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in setting timezone.`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to set timezone. message: ${error.message}, code: ${error.code}`);
}

systemTime.setTimezone(deprecated)

setTimezone(timezone: string): Promise<void>

使用Promise异步回调设置系统时区。

需要权限: ohos.permission.SET_TIME_ZONE

系统能力: SystemCapability.MiscServices.Time

参数:

参数名类型必填说明
timezonestring系统时区。具体可见支持的系统时区

返回值:

类型说明
Promise<void>无返回结果的Promise对象。

错误码:

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

错误码ID错误信息
-1Parameter check failed, permission denied, or system error.

示例:

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

try {
  systemTime.setTimezone('Asia/Shanghai').then(() => {
    console.info(`Succeeded in setting timezone.`);
  }).catch((error: BusinessError) => {
    console.info(`Failed to setting timezone. message: ${error.message}, code: ${error.code}`);
  });
} catch(e) {
  let error = e as BusinessError;
  console.info(`Failed to set timezone. message: ${error.message}, code: ${error.code}`);
}

支持的系统时区

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

时区偏移量
Antarctica/McMurdo12
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

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Basic Services Kit(基础服务)

harmony 鸿蒙DeviceInfo

harmony 鸿蒙OH_Print

harmony 鸿蒙Print_Margin

harmony 鸿蒙Print_PageSize

harmony 鸿蒙Print_PrintAttributes

harmony 鸿蒙Print_PrintDocCallback

harmony 鸿蒙Print_Range

harmony 鸿蒙TimeService

harmony 鸿蒙ohscan.h

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/t5y5zG