提交 e5d7149a 编写于 作者: W wangtong 提交者: wTong888

fixed a95c821 from https://gitee.com/wTong6/docs/pulls/13519

添加time接口异常说明
Signed-off-by: Nwangtong <wangtong94@huawei.com>
上级 dcfc7ecc
......@@ -29,6 +29,14 @@ setTime(time : number, callback : AsyncCallback&lt;void&gt;) : void
| time | number | 是 | 目标时间戳(ms)。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
**错误码:**
以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------------------------ |
| -1 | The parameter check failed or permission denied or system error. |
**示例:**
```js
......@@ -65,6 +73,14 @@ setTime(time : number) : 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
......@@ -92,6 +108,14 @@ getCurrentTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): 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
......@@ -118,6 +142,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
......@@ -150,6 +182,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
......@@ -175,6 +215,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
......@@ -201,6 +249,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
......@@ -233,6 +289,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
......@@ -258,6 +322,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
......@@ -284,6 +356,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
......@@ -316,6 +396,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
......@@ -343,6 +431,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
......@@ -378,6 +474,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
......@@ -403,6 +507,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
......@@ -456,6 +568,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
......@@ -490,6 +610,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
......@@ -514,6 +642,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
......@@ -540,6 +676,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
......
# 时间时区服务错误码
## -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. 系统运行异常。确认内存是否足够。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册