!13519 添加time接口异常说明

Merge pull request !13519 from wTong888/master

zh-cn/application-dev/reference/apis/js-apis-system-time.md

@@ -29,6 +29,14 @@ setTime(time : number, callback : AsyncCallback<void>) : void
 | time     | number                    | 是   | 目标时间戳（ms）。                         |
 | callback | AsyncCallback<void> | 是   | 回调函数。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                                     |
+| -------- | ------------------------------------------------------------ |
+| -1       | The parameter check failed or permission denied or system error. |
+
 **示例：**
 
 ```js
@@ -69,6 +77,14 @@ setTime(time : number) : Promise<void>
 | ------------------- | ------------------------- |
 | Promise<void> | 无返回结果的Promise对象。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                                     |
+| -------- | ------------------------------------------------------------ |
+| -1       | The parameter check failed or permission denied or system error. |
+
 **示例：**
 
 ```js
@@ -104,6 +120,14 @@ getCurrentTime(isNano: boolean, callback: AsyncCallback<number>): void
 | isNano   | boolean                     | 是   | 返回结果是否为纳秒数。<br>- true：表示返回结果为纳秒数（ns）。 <br>- false：表示返回结果为毫秒数（ms）。 |
 | callback | AsyncCallback&lt;number&gt; | 是   | 回调函数，返回自Unix纪元以来经过的时间。         |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -138,6 +162,14 @@ getCurrentTime(callback: AsyncCallback&lt;number&gt;): void
 | -------- | ----------- | ---- | ---------------------------------- |
 | callback | AsyncCallback&lt;number&gt; | 是   | 回调函数，返回自Unix纪元以来经过的时间。         |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -178,6 +210,14 @@ getCurrentTime(isNano?: boolean): Promise&lt;number&gt;
 | --------------------- | --------------------------- |
 | Promise&lt;number&gt; | Promise对象，返回自Unix纪元以来经过的时间。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -211,6 +251,14 @@ getRealActiveTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
 | isNano   | boolean                     | 是   | 返回结果是否为纳秒数。<br/>- true：表示返回结果为纳秒数（ns）。 <br/>- false：表示返回结果为毫秒数（ms）。 |
 | callback | AsyncCallback&lt;number&gt; | 是   | 回调函数，返回自系统启动以来经过的时间，但不包括度睡眠时间。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -245,6 +293,14 @@ getRealActiveTime(callback: AsyncCallback&lt;number&gt;): void
 | -------- | -------------- | ---- | --------------------- |
 | callback | AsyncCallback&lt;number&gt; | 是   | 回调函数，返回自系统启动以来经过的时间，但不包括度睡眠时间。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -285,6 +341,14 @@ getRealActiveTime(isNano?: boolean): Promise&lt;number&gt;
 | -------------- | -------------------------------- |
 | Promise&lt;number&gt; | Promise对象，返回自系统启动以来经过的时间，但不包括深度睡眠时间。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -318,6 +382,14 @@ getRealTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
 | isNano   | boolean                     | 是   | 返回结果是否为纳秒数。<br/>- true：表示返回结果为纳秒数（ns）。 <br/>- false：表示返回结果为毫秒数（ms）。 |
 | callback | AsyncCallback&lt;number&gt; | 是   | 回调函数，返回自系统启动以来经过的时间，包括深度睡眠时间。   |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -352,6 +424,14 @@ getRealTime(callback: AsyncCallback&lt;number&gt;): void
 | -------- | --------- | ---- | --------------------------- |
 | callback | AsyncCallback&lt;number&gt; | 是   | 回调函数，返回自系统启动以来经过的时间，包括深度睡眠时间。   |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -392,6 +472,14 @@ getRealTime(isNano?: boolean): Promise&lt;number&gt;
 | --------------------- | ------------------------------- |
 | Promise&lt;number&gt; | Promise对象，返回自系统启动以来经过的时间，包括深度睡眠时间。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -423,6 +511,14 @@ setDate(date: Date, callback: AsyncCallback&lt;void&gt;): void
 | date     | Date                      | 是   | 目标日期。                                 |
 | callback | AsyncCallback&lt;void&gt; | 是   | 回调函数。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                                     |
+| -------- | ------------------------------------------------------------ |
+| -1       | The parameter check failed or permission denied or system error. |
+
 **示例：**
 
 ```js
@@ -462,6 +558,14 @@ setDate(date: Date): Promise&lt;void&gt;
 | ------------------- | -------------------- |
 | Promise&lt;void&gt; | 无返回结果的Promise对象。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                                     |
+| -------- | ------------------------------------------------------------ |
+| -1       | The parameter check failed or permission denied or system error. |
+
 **示例：**
 
 ```js
@@ -495,6 +599,14 @@ getDate(callback: AsyncCallback&lt;Date&gt;): void
 | -------- | -------------- | ---- | --------------------- |
 | callback | AsyncCallback&lt;Date&gt; | 是   | 回调函数，返回当前系统日期。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -529,6 +641,14 @@ getDate(): Promise&lt;Date&gt;
 | ------------------- | ----------------------------------------- |
 | Promise&lt;Date&gt; | Promise对象，返回当前系统日期。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -560,6 +680,14 @@ setTimezone(timezone: string, callback: AsyncCallback&lt;void&gt;): void
 | timezone | string                    | 是   | 系统时区。 具体可见[支持的系统时区](#支持的系统时区) 。        |
 | callback | AsyncCallback&lt;void&gt; | 是   | 回调函数。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                                     |
+| -------- | ------------------------------------------------------------ |
+| -1       | The parameter check failed or permission denied or system error. |
+
 **示例：**
 
 ```js
@@ -598,6 +726,14 @@ setTimezone(timezone: string): Promise&lt;void&gt;
 | ------------------- | -------------------- |
 | Promise&lt;void&gt; | 无返回结果的Promise对象。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                                     |
+| -------- | ------------------------------------------------------------ |
+| -1       | The parameter check failed or permission denied or system error. |
+
 **示例：**
 
 ```js
@@ -630,6 +766,14 @@ getTimezone(callback: AsyncCallback&lt;string&gt;): void
 | -------- | --------- | ---- | ------------------------ |
 | callback | AsyncCallback&lt;string&gt; | 是   | 回调函数，返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js
@@ -664,6 +808,14 @@ getTimezone(): Promise&lt;string&gt;
 | --------------------- | ------------------------------------- |
 | Promise&lt;string&gt; | Promise对象，返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。
+
+| 错误码ID | 错误信息                                    |
+| -------- | ------------------------------------------- |
+| -1       | The parameter check failed or system error. |
+
 **示例：**
 
 ```js

zh-cn/application-dev/reference/errorcodes/errorcode-time.md

+# 时间时区服务错误码
+
+## -1 锁屏服务异常
+
+**错误信息** 
+
+  The parameter check failed or permission denied or system error.
+
+**错误描述**
+
+参数校验失败、权限校验失败或者时间时区服务异常。
+
+**可能原因**
+
+该错误码代表一种通用错误码，可根据错误信息判断具体异常，可能原因如下：
+1. 参数校验失败，传入参数无效。
+2. 权限校验失败，权限未配置。应用设置时间未配置ohos.permission.SET_TIME或者设置时区未配置ohos.permission.SET_TIME_ZONE。
+3. 系统运行异常。内存申请、多线程处理等内核通用错误。
+
+**处理步骤**
+
+1. 参数校验失败，传入参数无效。检查参数是否按照要求传入。
+2. 权限校验失败，应用设置时间配置ohos.permission.SET_TIME或者设置时区配置ohos.permission.SET_TIME_ZONE。
+3. 系统运行异常。确认内存是否足够。