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