1e41f4b71Sopenharmony_ci# @ohos.systemDateTime (系统时间、时区) 2e41f4b71Sopenharmony_ci 3e41f4b71Sopenharmony_ci本模块主要由系统时间和系统时区功能组成。开发者可以设置、获取系统时间及系统时区。 4e41f4b71Sopenharmony_ci 5e41f4b71Sopenharmony_ci> **说明:** 6e41f4b71Sopenharmony_ci> 7e41f4b71Sopenharmony_ci> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 8e41f4b71Sopenharmony_ci 9e41f4b71Sopenharmony_ci## 导入模块 10e41f4b71Sopenharmony_ci 11e41f4b71Sopenharmony_ci```ts 12e41f4b71Sopenharmony_ciimport { systemDateTime } from '@kit.BasicServicesKit'; 13e41f4b71Sopenharmony_ci``` 14e41f4b71Sopenharmony_ci 15e41f4b71Sopenharmony_ci## TimeType<sup>10+</sup> 16e41f4b71Sopenharmony_ci 17e41f4b71Sopenharmony_ci定义获取时间的枚举类型。 18e41f4b71Sopenharmony_ci 19e41f4b71Sopenharmony_ci**系统能力**: SystemCapability.MiscServices.Time 20e41f4b71Sopenharmony_ci 21e41f4b71Sopenharmony_ci| 名称 | 值 | 说明 | 22e41f4b71Sopenharmony_ci| ------- | ---- | ------------------------------------------------ | 23e41f4b71Sopenharmony_ci| STARTUP | 0 | 自系统启动以来经过的毫秒数,包括深度睡眠时间。 | 24e41f4b71Sopenharmony_ci| ACTIVE | 1 | 自系统启动以来经过的毫秒数,不包括深度睡眠时间。 | 25e41f4b71Sopenharmony_ci 26e41f4b71Sopenharmony_ci## systemDateTime.getCurrentTime<sup>(deprecated)</sup> 27e41f4b71Sopenharmony_ci 28e41f4b71Sopenharmony_cigetCurrentTime(isNano: boolean, callback: AsyncCallback<number>): void 29e41f4b71Sopenharmony_ci 30e41f4b71Sopenharmony_ci获取自Unix纪元以来经过的时间,使用callback异步回调。 31e41f4b71Sopenharmony_ci 32e41f4b71Sopenharmony_ci> **说明:** 33e41f4b71Sopenharmony_ci> 34e41f4b71Sopenharmony_ci> 从API Version 12开始不再维护,建议使用[systemDateTime.getTime<sup>10+</sup>](#systemdatetimegettime10)替代。 35e41f4b71Sopenharmony_ci 36e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 37e41f4b71Sopenharmony_ci 38e41f4b71Sopenharmony_ci**参数:** 39e41f4b71Sopenharmony_ci 40e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 41e41f4b71Sopenharmony_ci| -------- | -------------- | ---- | ------------------ | 42e41f4b71Sopenharmony_ci| isNano | boolean | 是 | 返回结果是否为纳秒数。<br>- true:表示返回结果为纳秒数(ns)。 <br>- false:表示返回结果为毫秒数(ms)。 | 43e41f4b71Sopenharmony_ci| callback | AsyncCallback<number> | 是 | 回调函数,返回自Unix纪元以来经过的时间戳。 | 44e41f4b71Sopenharmony_ci 45e41f4b71Sopenharmony_ci**错误码:** 46e41f4b71Sopenharmony_ci 47e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 48e41f4b71Sopenharmony_ci 49e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 50e41f4b71Sopenharmony_ci| -------- |-------------------------------------------------------------------| 51e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. | 52e41f4b71Sopenharmony_ci 53e41f4b71Sopenharmony_ci**示例:** 54e41f4b71Sopenharmony_ci 55e41f4b71Sopenharmony_ci```ts 56e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 57e41f4b71Sopenharmony_ci 58e41f4b71Sopenharmony_citry { 59e41f4b71Sopenharmony_ci systemDateTime.getCurrentTime(true, (error: BusinessError, time: number) => { 60e41f4b71Sopenharmony_ci if (error) { 61e41f4b71Sopenharmony_ci console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`); 62e41f4b71Sopenharmony_ci return; 63e41f4b71Sopenharmony_ci } 64e41f4b71Sopenharmony_ci console.info(`Succeeded in getting currentTime : ${time}`); 65e41f4b71Sopenharmony_ci }); 66e41f4b71Sopenharmony_ci} catch(e) { 67e41f4b71Sopenharmony_ci let error = e as BusinessError; 68e41f4b71Sopenharmony_ci console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`); 69e41f4b71Sopenharmony_ci} 70e41f4b71Sopenharmony_ci``` 71e41f4b71Sopenharmony_ci 72e41f4b71Sopenharmony_ci## systemDateTime.getCurrentTime<sup>(deprecated)</sup> 73e41f4b71Sopenharmony_ci 74e41f4b71Sopenharmony_cigetCurrentTime(callback: AsyncCallback<number>): void 75e41f4b71Sopenharmony_ci 76e41f4b71Sopenharmony_ci获取自Unix纪元以来经过的时间,使用callback异步回调。 77e41f4b71Sopenharmony_ci 78e41f4b71Sopenharmony_ci> **说明:** 79e41f4b71Sopenharmony_ci> 80e41f4b71Sopenharmony_ci> 从API Version 12开始不再维护,建议使用[systemDateTime.getTime<sup>10+</sup>](#systemdatetimegettime10)替代。 81e41f4b71Sopenharmony_ci 82e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 83e41f4b71Sopenharmony_ci 84e41f4b71Sopenharmony_ci**参数:** 85e41f4b71Sopenharmony_ci 86e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 87e41f4b71Sopenharmony_ci| -------- | ----------- | ---- | ---------------------------------- | 88e41f4b71Sopenharmony_ci| callback | AsyncCallback<number> | 是 | 回调函数,返回自Unix纪元以来经过的时间戳(ms)。 | 89e41f4b71Sopenharmony_ci 90e41f4b71Sopenharmony_ci**错误码:** 91e41f4b71Sopenharmony_ci 92e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 93e41f4b71Sopenharmony_ci 94e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 95e41f4b71Sopenharmony_ci|----------|-------------------------------------------------------------------| 96e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. | 97e41f4b71Sopenharmony_ci 98e41f4b71Sopenharmony_ci**示例:** 99e41f4b71Sopenharmony_ci 100e41f4b71Sopenharmony_ci```ts 101e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 102e41f4b71Sopenharmony_ci 103e41f4b71Sopenharmony_citry { 104e41f4b71Sopenharmony_ci systemDateTime.getCurrentTime((error: BusinessError, time: number) => { 105e41f4b71Sopenharmony_ci if (error) { 106e41f4b71Sopenharmony_ci console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`); 107e41f4b71Sopenharmony_ci return; 108e41f4b71Sopenharmony_ci } 109e41f4b71Sopenharmony_ci console.info(`Succeeded in getting currentTime : ${time}`); 110e41f4b71Sopenharmony_ci }); 111e41f4b71Sopenharmony_ci} catch(e) { 112e41f4b71Sopenharmony_ci let error = e as BusinessError; 113e41f4b71Sopenharmony_ci console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`); 114e41f4b71Sopenharmony_ci} 115e41f4b71Sopenharmony_ci``` 116e41f4b71Sopenharmony_ci 117e41f4b71Sopenharmony_ci## systemDateTime.getCurrentTime<sup>(deprecated)</sup> 118e41f4b71Sopenharmony_ci 119e41f4b71Sopenharmony_cigetCurrentTime(isNano?: boolean): Promise<number> 120e41f4b71Sopenharmony_ci 121e41f4b71Sopenharmony_ci获取自Unix纪元以来经过的时间,使用Promise异步回调。 122e41f4b71Sopenharmony_ci 123e41f4b71Sopenharmony_ci> **说明:** 124e41f4b71Sopenharmony_ci> 125e41f4b71Sopenharmony_ci> 从API Version 12开始不再维护,建议使用[systemDateTime.getTime<sup>10+</sup>](#systemdatetimegettime10)替代。 126e41f4b71Sopenharmony_ci 127e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 128e41f4b71Sopenharmony_ci 129e41f4b71Sopenharmony_ci**参数:** 130e41f4b71Sopenharmony_ci 131e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 132e41f4b71Sopenharmony_ci| ------ | ------- | ---- | ------------------------- | 133e41f4b71Sopenharmony_ci| isNano | boolean | 否 | 返回结果是否为纳秒数,默认值为false。<br/>- true:表示返回结果为纳秒数(ns)。 <br/>- false:表示返回结果为毫秒数(ms)。 | 134e41f4b71Sopenharmony_ci 135e41f4b71Sopenharmony_ci**返回值:** 136e41f4b71Sopenharmony_ci 137e41f4b71Sopenharmony_ci| 类型 | 说明 | 138e41f4b71Sopenharmony_ci| --------------------- | --------------------------- | 139e41f4b71Sopenharmony_ci| Promise<number> | Promise对象,返回自Unix纪元以来经过的时间戳。 | 140e41f4b71Sopenharmony_ci 141e41f4b71Sopenharmony_ci**错误码:** 142e41f4b71Sopenharmony_ci 143e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 144e41f4b71Sopenharmony_ci 145e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 146e41f4b71Sopenharmony_ci|---------|-------------------------------------------------------------------| 147e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. | 148e41f4b71Sopenharmony_ci 149e41f4b71Sopenharmony_ci**示例:** 150e41f4b71Sopenharmony_ci 151e41f4b71Sopenharmony_ci```ts 152e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 153e41f4b71Sopenharmony_ci 154e41f4b71Sopenharmony_citry { 155e41f4b71Sopenharmony_ci systemDateTime.getCurrentTime().then((time: number) => { 156e41f4b71Sopenharmony_ci console.info(`Succeeded in getting currentTime : ${time}`); 157e41f4b71Sopenharmony_ci }).catch((error: BusinessError) => { 158e41f4b71Sopenharmony_ci console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`); 159e41f4b71Sopenharmony_ci }); 160e41f4b71Sopenharmony_ci} catch(e) { 161e41f4b71Sopenharmony_ci let error = e as BusinessError; 162e41f4b71Sopenharmony_ci console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`); 163e41f4b71Sopenharmony_ci} 164e41f4b71Sopenharmony_ci``` 165e41f4b71Sopenharmony_ci 166e41f4b71Sopenharmony_ci## systemDateTime.getRealActiveTime<sup>(deprecated)</sup> 167e41f4b71Sopenharmony_ci 168e41f4b71Sopenharmony_cigetRealActiveTime(isNano: boolean, callback: AsyncCallback<number>): void 169e41f4b71Sopenharmony_ci 170e41f4b71Sopenharmony_ci获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback异步回调。 171e41f4b71Sopenharmony_ci 172e41f4b71Sopenharmony_ci> **说明:** 173e41f4b71Sopenharmony_ci> 174e41f4b71Sopenharmony_ci> 从API Version 12开始不再维护,建议使用[systemDateTime.getUptime<sup>10+</sup>](#systemdatetimegetuptime10)替代。 175e41f4b71Sopenharmony_ci 176e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 177e41f4b71Sopenharmony_ci 178e41f4b71Sopenharmony_ci**参数:** 179e41f4b71Sopenharmony_ci 180e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 181e41f4b71Sopenharmony_ci| -------- | ---------- | ---- | -------------------------- | 182e41f4b71Sopenharmony_ci| isNano | boolean | 是 | 返回结果是否为纳秒数。<br/>- true:表示返回结果为纳秒数(ns)。 <br/>- false:表示返回结果为毫秒数(ms)。 | 183e41f4b71Sopenharmony_ci| callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 | 184e41f4b71Sopenharmony_ci 185e41f4b71Sopenharmony_ci**错误码:** 186e41f4b71Sopenharmony_ci 187e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 188e41f4b71Sopenharmony_ci 189e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 190e41f4b71Sopenharmony_ci|---------|-------------------------------------------------------------------| 191e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. | 192e41f4b71Sopenharmony_ci 193e41f4b71Sopenharmony_ci**示例:** 194e41f4b71Sopenharmony_ci 195e41f4b71Sopenharmony_ci```ts 196e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 197e41f4b71Sopenharmony_ci 198e41f4b71Sopenharmony_citry { 199e41f4b71Sopenharmony_ci systemDateTime.getRealActiveTime(true, (error: BusinessError, time: number) => { 200e41f4b71Sopenharmony_ci if (error) { 201e41f4b71Sopenharmony_ci console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`); 202e41f4b71Sopenharmony_ci return; 203e41f4b71Sopenharmony_ci } 204e41f4b71Sopenharmony_ci console.info(`Succeeded in getting real active time : ${time}`); 205e41f4b71Sopenharmony_ci }); 206e41f4b71Sopenharmony_ci} catch(e) { 207e41f4b71Sopenharmony_ci let error = e as BusinessError; 208e41f4b71Sopenharmony_ci console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`); 209e41f4b71Sopenharmony_ci} 210e41f4b71Sopenharmony_ci``` 211e41f4b71Sopenharmony_ci 212e41f4b71Sopenharmony_ci## systemDateTime.getRealActiveTime<sup>(deprecated)</sup> 213e41f4b71Sopenharmony_ci 214e41f4b71Sopenharmony_cigetRealActiveTime(callback: AsyncCallback<number>): void 215e41f4b71Sopenharmony_ci 216e41f4b71Sopenharmony_ci获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback异步回调。 217e41f4b71Sopenharmony_ci 218e41f4b71Sopenharmony_ci> **说明:** 219e41f4b71Sopenharmony_ci> 220e41f4b71Sopenharmony_ci> 从API Version 12开始不再维护,建议使用[systemDateTime.getUptime<sup>10+</sup>](#systemdatetimegetuptime10)替代。 221e41f4b71Sopenharmony_ci 222e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 223e41f4b71Sopenharmony_ci 224e41f4b71Sopenharmony_ci**参数:** 225e41f4b71Sopenharmony_ci 226e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 227e41f4b71Sopenharmony_ci| -------- | -------------- | ---- | --------------------- | 228e41f4b71Sopenharmony_ci| callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。 | 229e41f4b71Sopenharmony_ci 230e41f4b71Sopenharmony_ci**错误码:** 231e41f4b71Sopenharmony_ci 232e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 233e41f4b71Sopenharmony_ci 234e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 235e41f4b71Sopenharmony_ci|---------|-------------------------------------------------------------------| 236e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. | 237e41f4b71Sopenharmony_ci 238e41f4b71Sopenharmony_ci**示例:** 239e41f4b71Sopenharmony_ci 240e41f4b71Sopenharmony_ci```ts 241e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 242e41f4b71Sopenharmony_ci 243e41f4b71Sopenharmony_citry { 244e41f4b71Sopenharmony_ci systemDateTime.getRealActiveTime((error: BusinessError, time: number) => { 245e41f4b71Sopenharmony_ci if (error) { 246e41f4b71Sopenharmony_ci console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`); 247e41f4b71Sopenharmony_ci return; 248e41f4b71Sopenharmony_ci } 249e41f4b71Sopenharmony_ci console.info(`Succeeded in getting real active time : ${time}`); 250e41f4b71Sopenharmony_ci }); 251e41f4b71Sopenharmony_ci} catch(e) { 252e41f4b71Sopenharmony_ci let error = e as BusinessError; 253e41f4b71Sopenharmony_ci console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`); 254e41f4b71Sopenharmony_ci} 255e41f4b71Sopenharmony_ci``` 256e41f4b71Sopenharmony_ci 257e41f4b71Sopenharmony_ci## systemDateTime.getRealActiveTime<sup>(deprecated)</sup> 258e41f4b71Sopenharmony_ci 259e41f4b71Sopenharmony_cigetRealActiveTime(isNano?: boolean): Promise<number> 260e41f4b71Sopenharmony_ci 261e41f4b71Sopenharmony_ci获取自系统启动以来经过的时间,不包括深度睡眠时间,使用Promise异步回调。 262e41f4b71Sopenharmony_ci 263e41f4b71Sopenharmony_ci> **说明:** 264e41f4b71Sopenharmony_ci> 265e41f4b71Sopenharmony_ci> 从API Version 12开始不再维护,建议使用[systemDateTime.getUptime<sup>10+</sup>](#systemdatetimegetuptime10)替代。 266e41f4b71Sopenharmony_ci 267e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 268e41f4b71Sopenharmony_ci 269e41f4b71Sopenharmony_ci**参数:** 270e41f4b71Sopenharmony_ci 271e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 272e41f4b71Sopenharmony_ci| ------ | ------- | ---- | ----------------------------------- | 273e41f4b71Sopenharmony_ci| isNano | boolean | 否 | 返回结果是否为纳秒数,默认值为false。<br/>- true:表示返回结果为纳秒数(ns)。 <br/>- false:表示返回结果为毫秒数(ms)。 | 274e41f4b71Sopenharmony_ci 275e41f4b71Sopenharmony_ci**返回值:** 276e41f4b71Sopenharmony_ci 277e41f4b71Sopenharmony_ci| 类型 | 说明 | 278e41f4b71Sopenharmony_ci| -------------- | -------------------------------- | 279e41f4b71Sopenharmony_ci| Promise<number> | Promise对象,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 | 280e41f4b71Sopenharmony_ci 281e41f4b71Sopenharmony_ci**错误码:** 282e41f4b71Sopenharmony_ci 283e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 284e41f4b71Sopenharmony_ci 285e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 286e41f4b71Sopenharmony_ci|---------|-------------------------------------------------------------------| 287e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. | 288e41f4b71Sopenharmony_ci 289e41f4b71Sopenharmony_ci**示例:** 290e41f4b71Sopenharmony_ci 291e41f4b71Sopenharmony_ci```ts 292e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 293e41f4b71Sopenharmony_ci 294e41f4b71Sopenharmony_citry { 295e41f4b71Sopenharmony_ci systemDateTime.getRealActiveTime().then((time: number) => { 296e41f4b71Sopenharmony_ci console.info(`Succeeded in getting real active time : ${time}`); 297e41f4b71Sopenharmony_ci }).catch((error: BusinessError) => { 298e41f4b71Sopenharmony_ci console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`); 299e41f4b71Sopenharmony_ci }); 300e41f4b71Sopenharmony_ci} catch(e) { 301e41f4b71Sopenharmony_ci let error = e as BusinessError; 302e41f4b71Sopenharmony_ci console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`); 303e41f4b71Sopenharmony_ci} 304e41f4b71Sopenharmony_ci``` 305e41f4b71Sopenharmony_ci 306e41f4b71Sopenharmony_ci## systemDateTime.getRealTime<sup>(deprecated)</sup> 307e41f4b71Sopenharmony_ci 308e41f4b71Sopenharmony_cigetRealTime(isNano: boolean, callback: AsyncCallback<number>): void 309e41f4b71Sopenharmony_ci 310e41f4b71Sopenharmony_ci获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback异步回调。 311e41f4b71Sopenharmony_ci 312e41f4b71Sopenharmony_ci> **说明:** 313e41f4b71Sopenharmony_ci> 314e41f4b71Sopenharmony_ci> 从API Version 12开始不再维护,建议使用[systemDateTime.getUptime<sup>10+</sup>](#systemdatetimegetuptime10)替代。 315e41f4b71Sopenharmony_ci 316e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 317e41f4b71Sopenharmony_ci 318e41f4b71Sopenharmony_ci**参数:** 319e41f4b71Sopenharmony_ci 320e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 321e41f4b71Sopenharmony_ci| -------- | --------------- | ---- | ------------------------------- | 322e41f4b71Sopenharmony_ci| isNano | boolean | 是 | 返回结果是否为纳秒数。<br/>- true:表示返回结果为纳秒数(ns)。 <br/>- false:表示返回结果为毫秒数(ms)。 | 323e41f4b71Sopenharmony_ci| callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 | 324e41f4b71Sopenharmony_ci 325e41f4b71Sopenharmony_ci**错误码:** 326e41f4b71Sopenharmony_ci 327e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 328e41f4b71Sopenharmony_ci 329e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 330e41f4b71Sopenharmony_ci|---------|-------------------------------------------------------------------| 331e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. | 332e41f4b71Sopenharmony_ci 333e41f4b71Sopenharmony_ci**示例:** 334e41f4b71Sopenharmony_ci 335e41f4b71Sopenharmony_ci```ts 336e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 337e41f4b71Sopenharmony_ci 338e41f4b71Sopenharmony_citry { 339e41f4b71Sopenharmony_ci systemDateTime.getRealTime(true, (error: BusinessError, time: number) => { 340e41f4b71Sopenharmony_ci if (error) { 341e41f4b71Sopenharmony_ci console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`); 342e41f4b71Sopenharmony_ci return; 343e41f4b71Sopenharmony_ci } 344e41f4b71Sopenharmony_ci console.info(`Succeeded in getting real time : ${time}`); 345e41f4b71Sopenharmony_ci }); 346e41f4b71Sopenharmony_ci} catch(e) { 347e41f4b71Sopenharmony_ci let error = e as BusinessError; 348e41f4b71Sopenharmony_ci console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`); 349e41f4b71Sopenharmony_ci} 350e41f4b71Sopenharmony_ci``` 351e41f4b71Sopenharmony_ci 352e41f4b71Sopenharmony_ci## systemDateTime.getRealTime<sup>(deprecated)</sup> 353e41f4b71Sopenharmony_ci 354e41f4b71Sopenharmony_cigetRealTime(callback: AsyncCallback<number>): void 355e41f4b71Sopenharmony_ci 356e41f4b71Sopenharmony_ci获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback异步回调。 357e41f4b71Sopenharmony_ci 358e41f4b71Sopenharmony_ci> **说明:** 359e41f4b71Sopenharmony_ci> 360e41f4b71Sopenharmony_ci> 从API Version 12开始不再维护,建议使用[systemDateTime.getUptime<sup>10+</sup>](#systemdatetimegetuptime10)替代。 361e41f4b71Sopenharmony_ci 362e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 363e41f4b71Sopenharmony_ci 364e41f4b71Sopenharmony_ci**参数:** 365e41f4b71Sopenharmony_ci 366e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 367e41f4b71Sopenharmony_ci| -------- | --------- | ---- | --------------------------- | 368e41f4b71Sopenharmony_ci| callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 | 369e41f4b71Sopenharmony_ci 370e41f4b71Sopenharmony_ci**错误码:** 371e41f4b71Sopenharmony_ci 372e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 373e41f4b71Sopenharmony_ci 374e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 375e41f4b71Sopenharmony_ci|---------|-------------------------------------------------------------------| 376e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. | 377e41f4b71Sopenharmony_ci 378e41f4b71Sopenharmony_ci**示例:** 379e41f4b71Sopenharmony_ci 380e41f4b71Sopenharmony_ci```ts 381e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 382e41f4b71Sopenharmony_ci 383e41f4b71Sopenharmony_citry { 384e41f4b71Sopenharmony_ci systemDateTime.getRealTime((error: BusinessError, time: number) => { 385e41f4b71Sopenharmony_ci if (error) { 386e41f4b71Sopenharmony_ci console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`); 387e41f4b71Sopenharmony_ci return; 388e41f4b71Sopenharmony_ci } 389e41f4b71Sopenharmony_ci console.info(`Succeeded in getting real time : ${time}`); 390e41f4b71Sopenharmony_ci }); 391e41f4b71Sopenharmony_ci} catch(e) { 392e41f4b71Sopenharmony_ci let error = e as BusinessError; 393e41f4b71Sopenharmony_ci console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`); 394e41f4b71Sopenharmony_ci} 395e41f4b71Sopenharmony_ci``` 396e41f4b71Sopenharmony_ci 397e41f4b71Sopenharmony_ci## systemDateTime.getRealTime<sup>(deprecated)</sup> 398e41f4b71Sopenharmony_ci 399e41f4b71Sopenharmony_cigetRealTime(isNano?: boolean): Promise<number> 400e41f4b71Sopenharmony_ci 401e41f4b71Sopenharmony_ci获取自系统启动以来经过的时间,包括深度睡眠时间,使用Promise异步回调。 402e41f4b71Sopenharmony_ci 403e41f4b71Sopenharmony_ci> **说明:** 404e41f4b71Sopenharmony_ci> 405e41f4b71Sopenharmony_ci> 从API Version 12开始不再维护,建议使用[systemDateTime.getUptime<sup>10+</sup>](#systemdatetimegetuptime10)替代。 406e41f4b71Sopenharmony_ci 407e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 408e41f4b71Sopenharmony_ci 409e41f4b71Sopenharmony_ci**参数:** 410e41f4b71Sopenharmony_ci 411e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 412e41f4b71Sopenharmony_ci| ------ | ------- | ---- | ------------------------------- | 413e41f4b71Sopenharmony_ci| isNano | boolean | 否 | 返回结果是否为纳秒数,默认值为false。<br/>- true:表示返回结果为纳秒数(ns)。 <br/>- false:表示返回结果为毫秒数(ms)。 | 414e41f4b71Sopenharmony_ci 415e41f4b71Sopenharmony_ci**返回值:** 416e41f4b71Sopenharmony_ci 417e41f4b71Sopenharmony_ci| 类型 | 说明 | 418e41f4b71Sopenharmony_ci| --------------------- | ------------------------------- | 419e41f4b71Sopenharmony_ci| Promise<number> | Promise对象,返回自系统启动以来经过的时间,包括深度睡眠时间。 | 420e41f4b71Sopenharmony_ci 421e41f4b71Sopenharmony_ci**错误码:** 422e41f4b71Sopenharmony_ci 423e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 424e41f4b71Sopenharmony_ci 425e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 426e41f4b71Sopenharmony_ci|---------|-------------------------------------------------------------------| 427e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.Incorrect parameter types. | 428e41f4b71Sopenharmony_ci 429e41f4b71Sopenharmony_ci**示例:** 430e41f4b71Sopenharmony_ci 431e41f4b71Sopenharmony_ci```ts 432e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 433e41f4b71Sopenharmony_ci 434e41f4b71Sopenharmony_citry { 435e41f4b71Sopenharmony_ci systemDateTime.getRealTime().then((time: number) => { 436e41f4b71Sopenharmony_ci console.info(`Succeeded in getting real time : ${time}`); 437e41f4b71Sopenharmony_ci }).catch((error: BusinessError) => { 438e41f4b71Sopenharmony_ci console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`); 439e41f4b71Sopenharmony_ci }); 440e41f4b71Sopenharmony_ci} catch(e) { 441e41f4b71Sopenharmony_ci let error = e as BusinessError; 442e41f4b71Sopenharmony_ci console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`); 443e41f4b71Sopenharmony_ci} 444e41f4b71Sopenharmony_ci``` 445e41f4b71Sopenharmony_ci 446e41f4b71Sopenharmony_ci## systemDateTime.getTime<sup>10+</sup> 447e41f4b71Sopenharmony_ci 448e41f4b71Sopenharmony_cigetTime(isNanoseconds?: boolean): number 449e41f4b71Sopenharmony_ci 450e41f4b71Sopenharmony_ci 使用同步方式获取自Unix纪元以来经过的时间。 451e41f4b71Sopenharmony_ci 452e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 453e41f4b71Sopenharmony_ci 454e41f4b71Sopenharmony_ci**参数:** 455e41f4b71Sopenharmony_ci 456e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 457e41f4b71Sopenharmony_ci| ------------- | ------- | ---- | ------------------------------------------------------------ | 458e41f4b71Sopenharmony_ci| isNanoseconds | boolean | 否 | 返回结果是否为纳秒数。<br>- true:表示返回结果为纳秒数(ns)。 <br>- false:表示返回结果为毫秒数(ms)。<br>默认值为false。 | 459e41f4b71Sopenharmony_ci 460e41f4b71Sopenharmony_ci**返回值**: 461e41f4b71Sopenharmony_ci 462e41f4b71Sopenharmony_ci| 类型 | 说明 | 463e41f4b71Sopenharmony_ci| ------ | -------------------------- | 464e41f4b71Sopenharmony_ci| number | 自Unix纪元以来经过的时间。 | 465e41f4b71Sopenharmony_ci 466e41f4b71Sopenharmony_ci**示例:** 467e41f4b71Sopenharmony_ci 468e41f4b71Sopenharmony_ci```ts 469e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 470e41f4b71Sopenharmony_ci 471e41f4b71Sopenharmony_citry { 472e41f4b71Sopenharmony_ci let time = systemDateTime.getTime(true) 473e41f4b71Sopenharmony_ci} catch(e) { 474e41f4b71Sopenharmony_ci let error = e as BusinessError; 475e41f4b71Sopenharmony_ci console.info(`Failed to get time. message: ${error.message}, code: ${error.code}`); 476e41f4b71Sopenharmony_ci} 477e41f4b71Sopenharmony_ci``` 478e41f4b71Sopenharmony_ci 479e41f4b71Sopenharmony_ci## systemDateTime.getUptime<sup>10+</sup> 480e41f4b71Sopenharmony_ci 481e41f4b71Sopenharmony_cigetUptime(timeType: TimeType, isNanoseconds?: boolean): number 482e41f4b71Sopenharmony_ci 483e41f4b71Sopenharmony_ci使用同步方式获取自系统启动以来经过的时间。 484e41f4b71Sopenharmony_ci 485e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 486e41f4b71Sopenharmony_ci 487e41f4b71Sopenharmony_ci**参数:** 488e41f4b71Sopenharmony_ci 489e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 490e41f4b71Sopenharmony_ci| ------------- | ----------------------- | ---- |-----------------------------------------------------------------------------------| 491e41f4b71Sopenharmony_ci| timeType | [TimeType](#timetype10) | 是 | 获取时间的类型,仅能为`STARTUP`或者`ACTIVE`。 | 492e41f4b71Sopenharmony_ci| isNanoseconds | boolean | 否 | 返回结果是否为纳秒数。<br/>- true:表示返回结果为纳秒数(ns)。 <br/>- false:表示返回结果为毫秒数(ms)。<br>默认值为false。 | 493e41f4b71Sopenharmony_ci 494e41f4b71Sopenharmony_ci**返回值:** 495e41f4b71Sopenharmony_ci 496e41f4b71Sopenharmony_ci| 类型 | 说明 | 497e41f4b71Sopenharmony_ci| ------ | -------------------------- | 498e41f4b71Sopenharmony_ci| number | 自系统启动以来经过的时间。 | 499e41f4b71Sopenharmony_ci 500e41f4b71Sopenharmony_ci**错误码:** 501e41f4b71Sopenharmony_ci 502e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](errorcode-time.md)。 503e41f4b71Sopenharmony_ci 504e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 505e41f4b71Sopenharmony_ci| -------- |----------------------------------------------------------------------------------------------------------------| 506e41f4b71Sopenharmony_ci| 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. | 507e41f4b71Sopenharmony_ci 508e41f4b71Sopenharmony_ci**示例:** 509e41f4b71Sopenharmony_ci 510e41f4b71Sopenharmony_ci```ts 511e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 512e41f4b71Sopenharmony_ci 513e41f4b71Sopenharmony_citry { 514e41f4b71Sopenharmony_ci let time = systemDateTime.getUptime(systemDateTime.TimeType.ACTIVE, false); 515e41f4b71Sopenharmony_ci} catch(e) { 516e41f4b71Sopenharmony_ci let error = e as BusinessError; 517e41f4b71Sopenharmony_ci console.info(`Failed to get uptime. message: ${error.message}, code: ${error.code}`); 518e41f4b71Sopenharmony_ci} 519e41f4b71Sopenharmony_ci``` 520e41f4b71Sopenharmony_ci 521e41f4b71Sopenharmony_ci## systemDateTime.getDate<sup>(deprecated)</sup> 522e41f4b71Sopenharmony_ci 523e41f4b71Sopenharmony_cigetDate(callback: AsyncCallback<Date>): void 524e41f4b71Sopenharmony_ci 525e41f4b71Sopenharmony_ci获取当前系统日期,使用callback异步回调。 526e41f4b71Sopenharmony_ci 527e41f4b71Sopenharmony_ci> **说明:** 528e41f4b71Sopenharmony_ci> 529e41f4b71Sopenharmony_ci> 从API version 9开始支持,从API 10开始废弃。建议使用new Date()替代,new Date()返回Date实例对象。 530e41f4b71Sopenharmony_ci 531e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 532e41f4b71Sopenharmony_ci 533e41f4b71Sopenharmony_ci**参数:** 534e41f4b71Sopenharmony_ci 535e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 536e41f4b71Sopenharmony_ci| -------- | -------------- | ---- | --------------------- | 537e41f4b71Sopenharmony_ci| callback | AsyncCallback<Date> | 是 | 回调函数,返回当前系统日期。 | 538e41f4b71Sopenharmony_ci 539e41f4b71Sopenharmony_ci**错误码:** 540e41f4b71Sopenharmony_ci 541e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 542e41f4b71Sopenharmony_ci 543e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 544e41f4b71Sopenharmony_ci|-------|------------------------------------------------------| 545e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.System error. | 546e41f4b71Sopenharmony_ci 547e41f4b71Sopenharmony_ci**示例:** 548e41f4b71Sopenharmony_ci 549e41f4b71Sopenharmony_ci```ts 550e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 551e41f4b71Sopenharmony_ci 552e41f4b71Sopenharmony_citry { 553e41f4b71Sopenharmony_ci systemDateTime.getDate((error: BusinessError, date: Date) => { 554e41f4b71Sopenharmony_ci if (error) { 555e41f4b71Sopenharmony_ci console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`); 556e41f4b71Sopenharmony_ci return; 557e41f4b71Sopenharmony_ci } 558e41f4b71Sopenharmony_ci console.info(`Succeeded in getting date : ${date}`);; 559e41f4b71Sopenharmony_ci }); 560e41f4b71Sopenharmony_ci} catch(e) { 561e41f4b71Sopenharmony_ci let error = e as BusinessError; 562e41f4b71Sopenharmony_ci console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`); 563e41f4b71Sopenharmony_ci} 564e41f4b71Sopenharmony_ci``` 565e41f4b71Sopenharmony_ci 566e41f4b71Sopenharmony_ci## systemDateTime.getDate<sup>(deprecated)</sup> 567e41f4b71Sopenharmony_ci 568e41f4b71Sopenharmony_cigetDate(): Promise<Date> 569e41f4b71Sopenharmony_ci 570e41f4b71Sopenharmony_ci获取当前系统日期,使用Promise异步回调。 571e41f4b71Sopenharmony_ci 572e41f4b71Sopenharmony_ci> **说明:** 573e41f4b71Sopenharmony_ci> 574e41f4b71Sopenharmony_ci> 从API version 9开始支持,从API 10开始废弃。建议使用new Date()替代,new Date()返回Date实例对象。 575e41f4b71Sopenharmony_ci 576e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 577e41f4b71Sopenharmony_ci 578e41f4b71Sopenharmony_ci**返回值:** 579e41f4b71Sopenharmony_ci 580e41f4b71Sopenharmony_ci| 类型 | 说明 | 581e41f4b71Sopenharmony_ci| ------------------- | ----------------------------------------- | 582e41f4b71Sopenharmony_ci| Promise<Date> | Promise对象,返回当前系统日期。 | 583e41f4b71Sopenharmony_ci 584e41f4b71Sopenharmony_ci**错误码:** 585e41f4b71Sopenharmony_ci 586e41f4b71Sopenharmony_ci以下错误码的详细介绍请参见[时间时区错误码](./errorcode-time.md)。 587e41f4b71Sopenharmony_ci 588e41f4b71Sopenharmony_ci| 错误码ID | 错误信息 | 589e41f4b71Sopenharmony_ci|-------|------------------------------------------------------| 590e41f4b71Sopenharmony_ci| 401 | Parameter error. Possible causes: 1.System error. | 591e41f4b71Sopenharmony_ci 592e41f4b71Sopenharmony_ci**示例:** 593e41f4b71Sopenharmony_ci 594e41f4b71Sopenharmony_ci```ts 595e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 596e41f4b71Sopenharmony_ci 597e41f4b71Sopenharmony_citry { 598e41f4b71Sopenharmony_ci systemDateTime.getDate().then((date: Date) => { 599e41f4b71Sopenharmony_ci console.info(`Succeeded in getting date : ${date}`); 600e41f4b71Sopenharmony_ci }).catch((error: BusinessError) => { 601e41f4b71Sopenharmony_ci console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`); 602e41f4b71Sopenharmony_ci }); 603e41f4b71Sopenharmony_ci} catch(e) { 604e41f4b71Sopenharmony_ci let error = e as BusinessError; 605e41f4b71Sopenharmony_ci console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`); 606e41f4b71Sopenharmony_ci} 607e41f4b71Sopenharmony_ci``` 608e41f4b71Sopenharmony_ci 609e41f4b71Sopenharmony_ci## systemDateTime.getTimezone 610e41f4b71Sopenharmony_ci 611e41f4b71Sopenharmony_cigetTimezone(callback: AsyncCallback<string>): void 612e41f4b71Sopenharmony_ci 613e41f4b71Sopenharmony_ci获取系统时区,使用callback异步回调。 614e41f4b71Sopenharmony_ci 615e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 616e41f4b71Sopenharmony_ci 617e41f4b71Sopenharmony_ci**参数:** 618e41f4b71Sopenharmony_ci 619e41f4b71Sopenharmony_ci| 参数名 | 类型 | 必填 | 说明 | 620e41f4b71Sopenharmony_ci| -------- | --------- | ---- | ------------------------ | 621e41f4b71Sopenharmony_ci| callback | AsyncCallback<string> | 是 | 回调函数,返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 | 622e41f4b71Sopenharmony_ci 623e41f4b71Sopenharmony_ci**示例:** 624e41f4b71Sopenharmony_ci 625e41f4b71Sopenharmony_ci```ts 626e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 627e41f4b71Sopenharmony_ci 628e41f4b71Sopenharmony_citry { 629e41f4b71Sopenharmony_ci systemDateTime.getTimezone((error: BusinessError, data: string) => { 630e41f4b71Sopenharmony_ci if (error) { 631e41f4b71Sopenharmony_ci console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`); 632e41f4b71Sopenharmony_ci return; 633e41f4b71Sopenharmony_ci } 634e41f4b71Sopenharmony_ci console.info(`Succeeded in get timezone : ${data}`);; 635e41f4b71Sopenharmony_ci }); 636e41f4b71Sopenharmony_ci} catch(e) { 637e41f4b71Sopenharmony_ci let error = e as BusinessError; 638e41f4b71Sopenharmony_ci console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`); 639e41f4b71Sopenharmony_ci} 640e41f4b71Sopenharmony_ci``` 641e41f4b71Sopenharmony_ci 642e41f4b71Sopenharmony_ci## systemDateTime.getTimezone 643e41f4b71Sopenharmony_ci 644e41f4b71Sopenharmony_cigetTimezone(): Promise<string> 645e41f4b71Sopenharmony_ci 646e41f4b71Sopenharmony_ci获取系统时区,使用Promise异步回调。 647e41f4b71Sopenharmony_ci 648e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 649e41f4b71Sopenharmony_ci 650e41f4b71Sopenharmony_ci**返回值:** 651e41f4b71Sopenharmony_ci 652e41f4b71Sopenharmony_ci| 类型 | 说明 | 653e41f4b71Sopenharmony_ci| --------------------- | ------------------------------------- | 654e41f4b71Sopenharmony_ci| Promise<string> | Promise对象,返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 | 655e41f4b71Sopenharmony_ci 656e41f4b71Sopenharmony_ci**示例:** 657e41f4b71Sopenharmony_ci 658e41f4b71Sopenharmony_ci```ts 659e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 660e41f4b71Sopenharmony_ci 661e41f4b71Sopenharmony_citry { 662e41f4b71Sopenharmony_ci systemDateTime.getTimezone().then((data: string) => { 663e41f4b71Sopenharmony_ci console.info(`Succeeded in getting timezone: ${data}`); 664e41f4b71Sopenharmony_ci }).catch((error: BusinessError) => { 665e41f4b71Sopenharmony_ci console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`); 666e41f4b71Sopenharmony_ci }); 667e41f4b71Sopenharmony_ci} catch(e) { 668e41f4b71Sopenharmony_ci let error = e as BusinessError; 669e41f4b71Sopenharmony_ci console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`); 670e41f4b71Sopenharmony_ci} 671e41f4b71Sopenharmony_ci``` 672e41f4b71Sopenharmony_ci 673e41f4b71Sopenharmony_ci## systemDateTime.getTimezoneSync<sup>10+</sup> 674e41f4b71Sopenharmony_ci 675e41f4b71Sopenharmony_cigetTimezoneSync(): string 676e41f4b71Sopenharmony_ci 677e41f4b71Sopenharmony_ci获取系统时区,使用同步方式。 678e41f4b71Sopenharmony_ci 679e41f4b71Sopenharmony_ci**系统能力:** SystemCapability.MiscServices.Time 680e41f4b71Sopenharmony_ci 681e41f4b71Sopenharmony_ci**返回值:** 682e41f4b71Sopenharmony_ci 683e41f4b71Sopenharmony_ci| 类型 | 说明 | 684e41f4b71Sopenharmony_ci| ------ | ---------------------------------------------------------- | 685e41f4b71Sopenharmony_ci| string | 返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 | 686e41f4b71Sopenharmony_ci 687e41f4b71Sopenharmony_ci**示例:** 688e41f4b71Sopenharmony_ci 689e41f4b71Sopenharmony_ci```ts 690e41f4b71Sopenharmony_ciimport { BusinessError } from '@kit.BasicServicesKit'; 691e41f4b71Sopenharmony_ci 692e41f4b71Sopenharmony_citry { 693e41f4b71Sopenharmony_ci let timezone = systemDateTime.getTimezoneSync(); 694e41f4b71Sopenharmony_ci} catch(e) { 695e41f4b71Sopenharmony_ci let error = e as BusinessError; 696e41f4b71Sopenharmony_ci console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`); 697e41f4b71Sopenharmony_ci} 698e41f4b71Sopenharmony_ci``` 699e41f4b71Sopenharmony_ci 700e41f4b71Sopenharmony_ci## 支持的系统时区 701e41f4b71Sopenharmony_ci 702e41f4b71Sopenharmony_ci支持的系统时区及各时区与0时区相比的偏移量(单位:h)可见下表。 703e41f4b71Sopenharmony_ci 704e41f4b71Sopenharmony_ci| 时区 | 偏移量 | 705e41f4b71Sopenharmony_ci| ------------------------------ | --------------------- | 706e41f4b71Sopenharmony_ci| Antarctica/McMurdo | 12 | 707e41f4b71Sopenharmony_ci| America/Argentina/Buenos_Aires | -3 | 708e41f4b71Sopenharmony_ci| Australia/Sydney | 10 | 709e41f4b71Sopenharmony_ci| America/Noronha | -2 | 710e41f4b71Sopenharmony_ci| America/St_Johns | -3 | 711e41f4b71Sopenharmony_ci| Africa/Kinshasa | 1 | 712e41f4b71Sopenharmony_ci| America/Santiago | -3 | 713e41f4b71Sopenharmony_ci| Asia/Shanghai | 8 | 714e41f4b71Sopenharmony_ci| Asia/Nicosia | 3 | 715e41f4b71Sopenharmony_ci| Europe/Berlin | 2 | 716e41f4b71Sopenharmony_ci| America/Guayaquil | -5 | 717e41f4b71Sopenharmony_ci| Europe/Madrid | 2 | 718e41f4b71Sopenharmony_ci| Pacific/Pohnpei | 11 | 719e41f4b71Sopenharmony_ci| America/Godthab | -2 | 720e41f4b71Sopenharmony_ci| Asia/Jakarta | 7 | 721e41f4b71Sopenharmony_ci| Pacific/Tarawa | 12 | 722e41f4b71Sopenharmony_ci| Asia/Almaty | 6 | 723e41f4b71Sopenharmony_ci| Pacific/Majuro | 12 | 724e41f4b71Sopenharmony_ci| Asia/Ulaanbaatar | 8 | 725e41f4b71Sopenharmony_ci| America/Mexico_City | -5 | 726e41f4b71Sopenharmony_ci| Asia/Kuala_Lumpur | 8 | 727e41f4b71Sopenharmony_ci| Pacific/Auckland | 12 | 728e41f4b71Sopenharmony_ci| Pacific/Tahiti | -10 | 729e41f4b71Sopenharmony_ci| Pacific/Port_Moresby | 10 | 730e41f4b71Sopenharmony_ci| Asia/Gaza | 3 | 731e41f4b71Sopenharmony_ci| Europe/Lisbon | 1 | 732e41f4b71Sopenharmony_ci| Europe/Moscow | 3 | 733e41f4b71Sopenharmony_ci| Europe/Kiev | 3 | 734e41f4b71Sopenharmony_ci| Pacific/Wake | 12 | 735e41f4b71Sopenharmony_ci| America/New_York | -4 | 736e41f4b71Sopenharmony_ci| Asia/Tashkent | 5 |