• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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&lt;number&gt;): 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&lt;number&gt; | 是   | 回调函数,返回自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&lt;number&gt;): void
147
148获取自Unix纪元以来经过的时间,使用callback异步回调。
149
150**系统能力:** SystemCapability.MiscServices.Time
151
152**参数:**
153
154| 参数名   | 类型                        | 必填 | 说明                                     |
155| -------- | --------------------------- | ---- | ---------------------------------------- |
156| callback | AsyncCallback&lt;number&gt; | 是   | 回调函数,返回自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&lt;number&gt;
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&lt;number&gt; | 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&lt;number&gt;): 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&lt;number&gt; | 是   | 回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。 |
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&lt;number&gt;): void
266
267获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback异步回调。
268
269**系统能力:** SystemCapability.MiscServices.Time
270
271**参数:**
272
273| 参数名   | 类型                        | 必填 | 说明                                                         |
274| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
275| callback | AsyncCallback&lt;number&gt; | 是   | 回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。 |
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&lt;number&gt;
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&lt;number&gt; | 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&lt;number&gt;): 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&lt;number&gt; | 是   | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。   |
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&lt;number&gt;): void
385
386获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback异步回调。
387
388**系统能力:** SystemCapability.MiscServices.Time
389
390**参数:**
391
392| 参数名   | 类型                        | 必填 | 说明                                                       |
393| -------- | --------------------------- | ---- | ---------------------------------------------------------- |
394| callback | AsyncCallback&lt;number&gt; | 是   | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 |
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&lt;number&gt;
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&lt;number&gt; | 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&lt;void&gt;): 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&lt;void&gt; | 是   | 回调函数。 |
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&lt;void&gt;
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&lt;void&gt; | 无返回结果的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&lt;Date&gt;): void
552
553获取当前系统日期,使用callback异步回调。
554
555**系统能力:** SystemCapability.MiscServices.Time
556
557**参数:**
558
559| 参数名   | 类型                      | 必填 | 说明                         |
560| -------- | ------------------------- | ---- | ---------------------------- |
561| callback | AsyncCallback&lt;Date&gt; | 是   | 回调函数,返回当前系统日期。 |
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&lt;Date&gt;
590
591获取当前系统日期,使用Promise异步回调。
592
593**系统能力:** SystemCapability.MiscServices.Time
594
595**返回值:**
596
597| 类型                | 说明                            |
598| ------------------- | ------------------------------- |
599| Promise&lt;Date&gt; | 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&lt;void&gt;): 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&lt;void&gt; | 是   | 回调函数。                                              |
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&lt;void&gt;
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&lt;void&gt; | 无返回结果的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&lt;string&gt;): void
711
712获取系统时区,使用callback异步回调。
713
714**系统能力:** SystemCapability.MiscServices.Time
715
716**参数:**
717
718| 参数名   | 类型                        | 必填 | 说明                                                         |
719| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
720| callback | AsyncCallback&lt;string&gt; | 是   | 回调函数,返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 |
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&lt;string&gt;
749
750获取系统时区,使用Promise异步回调。
751
752**系统能力:** SystemCapability.MiscServices.Time
753
754**返回值:**
755
756| 类型                  | 说明                                                         |
757| --------------------- | ------------------------------------------------------------ |
758| Promise&lt;string&gt; | 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      |