diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-time.md b/zh-cn/application-dev/reference/apis/js-apis-system-time.md index ac791285ca3daff7fd7c85ce82ca9e6b30c3eb8e..0dcc9471533b4cc13dcbb37cc5c5f625734527ca 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-time.md +++ b/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 | 是 | 返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。 | | callback | AsyncCallback<number> | 是 | 回调函数,返回自Unix纪元以来经过的时间。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -138,6 +162,14 @@ getCurrentTime(callback: AsyncCallback<number>): void | -------- | ----------- | ---- | ---------------------------------- | | callback | AsyncCallback<number> | 是 | 回调函数,返回自Unix纪元以来经过的时间。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -178,6 +210,14 @@ getCurrentTime(isNano?: boolean): Promise<number> | --------------------- | --------------------------- | | Promise<number> | 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<number>): void | isNano | boolean | 是 | 返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。 | | callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -245,6 +293,14 @@ getRealActiveTime(callback: AsyncCallback<number>): void | -------- | -------------- | ---- | --------------------- | | callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,但不包括度睡眠时间。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -285,6 +341,14 @@ getRealActiveTime(isNano?: boolean): Promise<number> | -------------- | -------------------------------- | | Promise<number> | Promise对象,返回自系统启动以来经过的时间,但不包括深度睡眠时间。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -318,6 +382,14 @@ getRealTime(isNano: boolean, callback: AsyncCallback<number>): void | isNano | boolean | 是 | 返回结果是否为纳秒数。
- true:表示返回结果为纳秒数(ns)。
- false:表示返回结果为毫秒数(ms)。 | | callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -352,6 +424,14 @@ getRealTime(callback: AsyncCallback<number>): void | -------- | --------- | ---- | --------------------------- | | callback | AsyncCallback<number> | 是 | 回调函数,返回自系统启动以来经过的时间,包括深度睡眠时间。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -392,6 +472,14 @@ getRealTime(isNano?: boolean): Promise<number> | --------------------- | ------------------------------- | | Promise<number> | Promise对象,返回自系统启动以来经过的时间,包括深度睡眠时间。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -423,6 +511,14 @@ setDate(date: Date, callback: AsyncCallback<void>): void | date | Date | 是 | 目标日期。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../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<void> | ------------------- | -------------------- | | Promise<void> | 无返回结果的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<Date>): void | -------- | -------------- | ---- | --------------------- | | callback | AsyncCallback<Date> | 是 | 回调函数,返回当前系统日期。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -529,6 +641,14 @@ getDate(): Promise<Date> | ------------------- | ----------------------------------------- | | Promise<Date> | Promise对象,返回当前系统日期。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -560,6 +680,14 @@ setTimezone(timezone: string, callback: AsyncCallback<void>): void | timezone | string | 是 | 系统时区。 具体可见[支持的系统时区](#支持的系统时区) 。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../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<void> | ------------------- | -------------------- | | Promise<void> | 无返回结果的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<string>): void | -------- | --------- | ---- | ------------------------ | | callback | AsyncCallback<string> | 是 | 回调函数,返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js @@ -664,6 +808,14 @@ getTimezone(): Promise<string> | --------------------- | ------------------------------------- | | Promise<string> | Promise对象,返回系统时区。具体可见[支持的系统时区](#支持的系统时区) 。 | +**错误码:** + +以下错误码的详细介绍请参见[时间时区错误码](../errorcodes/errorcode-time.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------- | +| -1 | The parameter check failed or system error. | + **示例:** ```js diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-time.md b/zh-cn/application-dev/reference/errorcodes/errorcode-time.md new file mode 100644 index 0000000000000000000000000000000000000000..1ceca485130c9cb34734cd37c23f04b3c6249054 --- /dev/null +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-time.md @@ -0,0 +1,24 @@ +# 时间时区服务错误码 + +## -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. 系统运行异常。确认内存是否足够。