console.error(`Failed to destroy timer. message:${error.message}, code:${error.code}`);
console.error(`Failed to destroy timer. message: ${error.message}, code: ${error.code}`);
}
}
});
});
}catch(e){
}catch(e){
// Capture the parameter verification error.
// Capture the parameter verification error.
console.info(`Failed to destroy timer. message:${e.message}, code:${e.code}`);
console.info(`Failed to destroy timer. message: ${e.message}, code: ${e.code}`);
}
}
}
}
}
}
...
@@ -235,7 +236,7 @@ export default {
...
@@ -235,7 +236,7 @@ export default {
destroyTimer promise mode:
destroyTimer promise mode:
**Example**:
**Example**
```js
```js
exportdefault{
exportdefault{
...
@@ -254,12 +255,82 @@ export default {
...
@@ -254,12 +255,82 @@ export default {
console.log(`Succeeded in destroy timer. Data:`+data);
console.log(`Succeeded in destroy timer. Data:`+data);
}).catch((error)=>{
}).catch((error)=>{
// Capture the permission denial error.
// Capture the permission denial error.
console.info(`Failed to destroy timer. message:${error.message}, code:${error.code}`);
console.info(`Failed to destroy timer. message: ${error.message}, code: ${error.code}`);
});
});
}catch(e){
}catch(e){
// Capture the parameter verification error.
// Capture the parameter verification error.
console.info(`Failed to destroy timer. message:${e.message}, code:${e.code}`);
console.info(`Failed to destroy timer. message: ${e.message}, code: ${e.code}`);
}
}
}
}
}
}
```
```
## cl.time.2 API Error Change
Errors thrown by timer APIs of the time subsystem: **201** (permission denied), **202** (non-system application), and **401** (invalid parameters).
**Change Impacts**
Applications developed based on earlier versions can still use the APIs. When new APIs are used, errors must be captured and processed.
**Key API/Component Changes**
Before change:
- The API throws an error message with error code **-1**.
After change:
- The API throws an error message with an error code. Error code **201** indicates that the permission is denied, error code **202** indicates that the application is not a system application, and error code **401** indicates that the parameters are invalid.
Deprecated APIs can be replaced with new ones with same names.
| Original API | New API |
| ---------------- | -------------------- |
| @ohos.systemTime | @ohos.systemDateTime |
**Adaptation Guide**
Refer to the code below to capture errors when **systemTime** APIs are called in applications. In the examples, the **setTime** API is invoked.
In callback mode:
**Example**
```js
importsystemDateTimefrom@ohos.systemDateTime
// Set the system time to 2021-01-20 02:36:25.
lettime=1611081385000;
try{
systemDateTime.setTime(time,(error)=>{
// Capture permission denial and non-system-application errors.
if(error){
console.info(`Failed to setting time. message: ${error.message}, code: ${error.code}`);
return;
}
console.info(`Succeeded in setting time.`);
})
}catch(e){
// Capture the parameter verification error.
console.info(`Failed to set time. message: ${e.message}, code: ${e.code}`);
}
```
In promise mode:
**Example**
```js
importsystemDateTimefrom@ohos.systemDateTime
// Set the system time to 2021-01-20 02:36:25.
lettime=1611081385000;
try{
systemDateTime.setTime(time).then(()=>{
console.info(`Succeeded in setting time.`);
}).catch((error)=>{
// Capture permission denial and non-system-application errors.
console.info(`Failed to setting time. message: ${error.message}, code: ${error.code}`);
});
}catch(e){
// Capture the parameter verification error.
console.info(`Failed to set time. message: ${e.message}, code: ${e.code}`);
