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&lt;number&gt;): 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&lt;number&gt; | 是   | 回调函数,返回自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&lt;number&gt;): 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&lt;number&gt; | 是   | 回调函数,返回自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&lt;number&gt;
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&lt;number&gt; | 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&lt;number&gt;): 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&lt;number&gt; | 是   | 回调函数,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 |
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&lt;number&gt;): 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&lt;number&gt; | 是   | 回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。 |
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&lt;number&gt;
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&lt;number&gt; | 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&lt;number&gt;): 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&lt;number&gt; | 是   | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。   |
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&lt;number&gt;): 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&lt;number&gt; | 是   | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。   |
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&lt;number&gt;
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&lt;number&gt; | 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&lt;Date&gt;): 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&lt;Date&gt; | 是   | 回调函数,返回当前系统日期。 |
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&lt;Date&gt;
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&lt;Date&gt; | 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&lt;string&gt;): 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&lt;string&gt; | 是   | 回调函数,返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 |
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&lt;string&gt;
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&lt;string&gt; | 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                     |