提交 64e3af58 编写于 作者: W wangdongqi

Signed-off-by: wangdongqi <wangdongqi2@huawei.com>

 Changes to be committed:
上级 0a76d892
...@@ -35,15 +35,15 @@ setTime(time : number, callback : AsyncCallback&lt;void&gt;) : void ...@@ -35,15 +35,15 @@ setTime(time : number, callback : AsyncCallback&lt;void&gt;) : void
// time对应的时间为2021-01-20 02:36:25 // time对应的时间为2021-01-20 02:36:25
let time = 1611081385000; let time = 1611081385000;
try { try {
systemDateTime.setTime(time, (error) => { systemDateTime.setTime(time, (error) => {
if (error) { if (error) {
console.info(`Failed to set time. message:${error.message}, code:${error.code}`); console.info(`Failed to set time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in setting time`); console.info(`Succeeded in setting time`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set time. message:${e.message}, code:${e.code}`); console.info(`Failed to set time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -75,13 +75,13 @@ setTime(time : number) : Promise&lt;void&gt; ...@@ -75,13 +75,13 @@ setTime(time : number) : Promise&lt;void&gt;
// time对应的时间为2021-01-20 02:36:25 // time对应的时间为2021-01-20 02:36:25
let time = 1611081385000; let time = 1611081385000;
try { try {
systemDateTime.setTime(time).then(() => { systemDateTime.setTime(time).then(() => {
console.info(`Succeeded in setting time.`); console.info(`Succeeded in setting time.`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to set time. message:${error.message}, code:${error.code}`); console.info(`Failed to set time. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set time. message:${e.message}, code:${e.code}`); console.info(`Failed to set time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -104,15 +104,15 @@ getCurrentTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void ...@@ -104,15 +104,15 @@ getCurrentTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemDateTime.getCurrentTime(true, (error, time) => { systemDateTime.getCurrentTime(true, (error, time) => {
if (error) { if (error) {
console.info(`Failed to get currentTime. message:${error.message}, code:${error.code}`); console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting currentTime : ${time}`); console.info(`Succeeded in getting currentTime : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get currentTime. message:${e.message}, code:${e.code}`); console.info(`Failed to get currentTime. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -134,15 +134,15 @@ getCurrentTime(callback: AsyncCallback&lt;number&gt;): void ...@@ -134,15 +134,15 @@ getCurrentTime(callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemDateTime.getCurrentTime((error, time) => { systemDateTime.getCurrentTime((error, time) => {
if (error) { if (error) {
console.info(`Failed to get currentTime. message:${error.message}, code:${error.code}`); console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting currentTime : ${time}`); console.info(`Succeeded in getting currentTime : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get currentTime. message:${e.message}, code:${e.code}`); console.info(`Failed to get currentTime. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -170,13 +170,13 @@ getCurrentTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -170,13 +170,13 @@ getCurrentTime(isNano?: boolean): Promise&lt;number&gt;
```js ```js
try { try {
systemDateTime.getCurrentTime().then((time) => { systemDateTime.getCurrentTime().then((time) => {
console.info(`Succeeded in getting currentTime : ${time}`); console.info(`Succeeded in getting currentTime : ${time}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to get currentTime. message:${error.message}, code:${error.code}`); console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get currentTime. message:${e.message}, code:${e.code}`); console.info(`Failed to get currentTime. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -199,15 +199,15 @@ getRealActiveTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void ...@@ -199,15 +199,15 @@ getRealActiveTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemDateTime.getRealActiveTime(true, (error, time) => { systemDateTime.getRealActiveTime(true, (error, time) => {
if (error) { if (error) {
console.info(`Failed to get real active time. message:${error.message}, code:${error.code}`); console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting real active time : ${time}`); console.info(`Succeeded in getting real active time : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real active time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real active time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -229,15 +229,15 @@ getRealActiveTime(callback: AsyncCallback&lt;number&gt;): void ...@@ -229,15 +229,15 @@ getRealActiveTime(callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemDateTime.getRealActiveTime((error, time) => { systemDateTime.getRealActiveTime((error, time) => {
if (error) { if (error) {
console.info(`Failed to get real active time. message:${error.message}, code:${error.code}`); console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting real active time : ${time}`); console.info(`Succeeded in getting real active time : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real active time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real active time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -265,13 +265,13 @@ getRealActiveTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -265,13 +265,13 @@ getRealActiveTime(isNano?: boolean): Promise&lt;number&gt;
```js ```js
try { try {
systemDateTime.getRealActiveTime().then((time) => { systemDateTime.getRealActiveTime().then((time) => {
console.info(`Succeeded in getting real active time : ${time}`); console.info(`Succeeded in getting real active time : ${time}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to get real active time. message:${error.message}, code:${error.code}`); console.info(`Failed to get real active time. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real active time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real active time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -294,15 +294,15 @@ getRealTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void ...@@ -294,15 +294,15 @@ getRealTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemDateTime.getRealTime(true, (error, time) => { systemDateTime.getRealTime(true, (error, time) => {
if (error) { if (error) {
console.info(`Failed to get real time. message:${error.message}, code:${error.code}`); console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting real time : ${time}`); console.info(`Succeeded in getting real time : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -324,15 +324,15 @@ getRealTime(callback: AsyncCallback&lt;number&gt;): void ...@@ -324,15 +324,15 @@ getRealTime(callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemDateTime.getRealTime((error, time) => { systemDateTime.getRealTime((error, time) => {
if (error) { if (error) {
console.info(`Failed to get real time. message:${error.message}, code:${error.code}`); console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting real time : ${time}`); console.info(`Succeeded in getting real time : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -360,13 +360,13 @@ getRealTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -360,13 +360,13 @@ getRealTime(isNano?: boolean): Promise&lt;number&gt;
```js ```js
try { try {
systemDateTime.getRealTime().then((time) => { systemDateTime.getRealTime().then((time) => {
console.info(`Succeeded in getting real time : ${time}`); console.info(`Succeeded in getting real time : ${time}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to get real time. message:${error.message}, code:${error.code}`); console.info(`Failed to get real time. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -392,15 +392,15 @@ setDate(date: Date, callback: AsyncCallback&lt;void&gt;): void ...@@ -392,15 +392,15 @@ setDate(date: Date, callback: AsyncCallback&lt;void&gt;): void
```js ```js
let date = new Date(); let date = new Date();
try { try {
systemDateTime.setDate(date, (error) => { systemDateTime.setDate(date, (error) => {
if (error) { if (error) {
console.info(`Failed to set date. message:${error.message}, code:${error.code}`); console.info(`Failed to set date. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in setting date.`); console.info(`Succeeded in setting date.`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set date. message:${e.message}, code:${e.code}`); console.info(`Failed to set date. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -431,13 +431,13 @@ setDate(date: Date): Promise&lt;void&gt; ...@@ -431,13 +431,13 @@ setDate(date: Date): Promise&lt;void&gt;
```js ```js
let date = new Date(); let date = new Date();
try { try {
systemDateTime.setDate(date).then(() => { systemDateTime.setDate(date).then(() => {
console.info(`Succeeded in setting date.`); console.info(`Succeeded in setting date.`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to set date. message:${error.message}, code:${error.code}`); console.info(`Failed to set date. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set date. message:${e.message}, code:${e.code}`); console.info(`Failed to set date. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -459,15 +459,15 @@ getDate(callback: AsyncCallback&lt;Date&gt;): void ...@@ -459,15 +459,15 @@ getDate(callback: AsyncCallback&lt;Date&gt;): void
```js ```js
try { try {
systemDateTime.getDate((error, date) => { systemDateTime.getDate((error, date) => {
if (error) { if (error) {
console.info(`Failed to get date. message:${error.message}, code:${error.code}`); console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting date : ${date}`);; console.info(`Succeeded in getting date : ${date}`);;
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get date. message:${e.message}, code:${e.code}`); console.info(`Failed to get date. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -489,13 +489,13 @@ getDate(): Promise&lt;Date&gt; ...@@ -489,13 +489,13 @@ getDate(): Promise&lt;Date&gt;
```js ```js
try { try {
systemDateTime.getDate().then((date) => { systemDateTime.getDate().then((date) => {
console.info(`Succeeded in getting date : ${date}`); console.info(`Succeeded in getting date : ${date}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to get date. message:${error.message}, code:${error.code}`); console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get date. message:${e.message}, code:${e.code}`); console.info(`Failed to get date. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -520,15 +520,15 @@ setTimezone(timezone: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -520,15 +520,15 @@ setTimezone(timezone: string, callback: AsyncCallback&lt;void&gt;): void
```js ```js
try { try {
systemDateTime.setTimezone('Asia/Shanghai', (error) => { systemDateTime.setTimezone('Asia/Shanghai', (error) => {
if (error) { if (error) {
console.info(`Failed to set timezone. message:${error.message}, code:${error.code}`); console.info(`Failed to set timezone. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in setting timezone.`); console.info(`Succeeded in setting timezone.`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set timezone. message:${e.message}, code:${e.code}`); console.info(`Failed to set timezone. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -558,13 +558,13 @@ setTimezone(timezone: string): Promise&lt;void&gt; ...@@ -558,13 +558,13 @@ setTimezone(timezone: string): Promise&lt;void&gt;
```js ```js
try { try {
systemDateTime.setTimezone('Asia/Shanghai').then(() => { systemDateTime.setTimezone('Asia/Shanghai').then(() => {
console.info(`Succeeded in setting timezone.`); console.info(`Succeeded in setting timezone.`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to set timezone. message:${error.message}, code:${error.code}`); console.info(`Failed to set timezone. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set timezone. message:${e.message}, code:${e.code}`); console.info(`Failed to set timezone. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -586,15 +586,15 @@ getTimezone(callback: AsyncCallback&lt;string&gt;): void ...@@ -586,15 +586,15 @@ getTimezone(callback: AsyncCallback&lt;string&gt;): void
```js ```js
try { try {
systemDateTime.getTimezone((error, data) => { systemDateTime.getTimezone((error, data) => {
if (error) { if (error) {
console.info(`Failed to get timezone. message:${error.message}, code:${error.code}`); console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in get timezone : ${data}`);; console.info(`Succeeded in get timezone : ${data}`);;
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get timezone. message:${e.message}, code:${e.code}`); console.info(`Failed to get timezone. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -616,13 +616,13 @@ getTimezone(): Promise&lt;string&gt; ...@@ -616,13 +616,13 @@ getTimezone(): Promise&lt;string&gt;
```js ```js
try { try {
systemDateTime.getTimezone().then((data) => { systemDateTime.getTimezone().then((data) => {
console.info(`Succeeded in getting timezone: ${data}`); console.info(`Succeeded in getting timezone: ${data}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to get timezone. message:${error.message}, code:${error.code}`); console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get timezone. message:${e.message}, code:${e.code}`); console.info(`Failed to get timezone. message: ${e.message}, code: ${e.code}`);
} }
``` ```
......
...@@ -35,15 +35,15 @@ setTime(time : number, callback : AsyncCallback&lt;void&gt;) : void ...@@ -35,15 +35,15 @@ setTime(time : number, callback : AsyncCallback&lt;void&gt;) : void
// time对应的时间为2021-01-20 02:36:25 // time对应的时间为2021-01-20 02:36:25
let time = 1611081385000; let time = 1611081385000;
try { try {
systemTime.setTime(time, (error) => { systemTime.setTime(time, (error) => {
if (error) { if (error) {
console.info(`Failed to setting time. message:${error.message}, code:${error.code}`); console.info(`Failed to setting time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in setting time`); }console.info(`Succeeded in setting time`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set time. message:${e.message}, code:${e.code}`); console.info(`Failed to set time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -75,13 +75,13 @@ setTime(time : number) : Promise&lt;void&gt; ...@@ -75,13 +75,13 @@ setTime(time : number) : Promise&lt;void&gt;
// time对应的时间为2021-01-20 02:36:25 // time对应的时间为2021-01-20 02:36:25
let time = 1611081385000; let time = 1611081385000;
try { try {
systemTime.setTime(time).then(() => { systemTime.setTime(time).then(() => {
console.info(`Succeeded in setting time.`); console.info(`Succeeded in setting time.`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to setting time. message:${error.message}, code:${error.code}`); console.info(`Failed to setting time. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set time. message:${e.message}, code:${e.code}`); console.info(`Failed to set time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -108,15 +108,15 @@ getCurrentTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void ...@@ -108,15 +108,15 @@ getCurrentTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemTime.getCurrentTime(true, (error, time) => { systemTime.getCurrentTime(true, (error, time) => {
if (error) { if (error) {
console.info(`Failed to getting currentTime. message:${error.message}, code:${error.code}`); console.info(`Failed to getting currentTime. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting currentTime : ${time}`); console.info(`Succeeded in getting currentTime: ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get currentTime. message:${e.message}, code:${e.code}`); console.info(`Failed to get currentTime. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -142,15 +142,15 @@ getCurrentTime(callback: AsyncCallback&lt;number&gt;): void ...@@ -142,15 +142,15 @@ getCurrentTime(callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemTime.getCurrentTime((error, time) => { systemTime.getCurrentTime((error, time) => {
if (error) { if (error) {
console.info(`Failed to getting currentTime. message:${error.message}, code:${error.code}`); console.info(`Failed to getting currentTime. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting currentTime : ${time}`); console.info(`Succeeded in getting currentTime : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get currentTime. message:${e.message}, code:${e.code}`); console.info(`Failed to get currentTime. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -182,13 +182,13 @@ getCurrentTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -182,13 +182,13 @@ getCurrentTime(isNano?: boolean): Promise&lt;number&gt;
```js ```js
try { try {
systemTime.getCurrentTime().then((time) => { systemTime.getCurrentTime().then((time) => {
console.info(`Succeeded in getting currentTime : ${time}`); console.info(`Succeeded in getting currentTime : ${time}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to getting currentTime. message:${error.message}, code:${error.code}`); console.info(`Failed to getting currentTime. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get currentTime. message:${e.message}, code:${e.code}`); console.info(`Failed to get currentTime. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -215,15 +215,15 @@ getRealActiveTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void ...@@ -215,15 +215,15 @@ getRealActiveTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemTime.getRealActiveTime(true, (error, time) => { systemTime.getRealActiveTime(true, (error, time) => {
if (error) { if (error) {
console.info(`Failed to getting real active time. message:${error.message}, code:${error.code}`); console.info(`Failed to getting real active time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting real active time : ${time}`); console.info(`Succeeded in getting real active time : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real active time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real active time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -249,15 +249,15 @@ getRealActiveTime(callback: AsyncCallback&lt;number&gt;): void ...@@ -249,15 +249,15 @@ getRealActiveTime(callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemTime.getRealActiveTime((error, time) => { systemTime.getRealActiveTime((error, time) => {
if (error) { if (error) {
console.info(`Failed to getting real active time. message:${error.message}, code:${error.code}`); console.info(`Failed to getting real active time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting real active time : ${time}`); console.info(`Succeeded in getting real active time : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real active time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real active time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -289,13 +289,13 @@ getRealActiveTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -289,13 +289,13 @@ getRealActiveTime(isNano?: boolean): Promise&lt;number&gt;
```js ```js
try { try {
systemTime.getRealActiveTime().then((time) => { systemTime.getRealActiveTime().then((time) => {
console.info(`Succeeded in getting real active time : ${time}`); console.info(`Succeeded in getting real active time : ${time}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to getting real active time. message:${error.message}, code:${error.code}`); console.info(`Failed to getting real active time. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real active time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real active time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -322,15 +322,15 @@ getRealTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void ...@@ -322,15 +322,15 @@ getRealTime(isNano: boolean, callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemTime.getRealTime(true, (error, time) => { systemTime.getRealTime(true, (error, time) => {
if (error) { if (error) {
console.info(`Failed to getting real time. message:${error.message}, code:${error.code}`); console.info(`Failed to getting real time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting real time : ${time}`); console.info(`Succeeded in getting real time : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -356,15 +356,15 @@ getRealTime(callback: AsyncCallback&lt;number&gt;): void ...@@ -356,15 +356,15 @@ getRealTime(callback: AsyncCallback&lt;number&gt;): void
```js ```js
try { try {
systemTime.getRealTime((error, time) => { systemTime.getRealTime((error, time) => {
if (error) { if (error) {
console.info(`Failed to getting real time. message:${error.message}, code:${error.code}`); console.info(`Failed to getting real time. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in getting real time : ${time}`); console.info(`Succeeded in getting real time : ${time}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -396,13 +396,13 @@ getRealTime(isNano?: boolean): Promise&lt;number&gt; ...@@ -396,13 +396,13 @@ getRealTime(isNano?: boolean): Promise&lt;number&gt;
```js ```js
try { try {
systemTime.getRealTime().then((time) => { systemTime.getRealTime().then((time) => {
console.info(`Succeeded in getting real time : ${time}`); console.info(`Succeeded in getting real time : ${time}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to getting real time. message:${error.message}, code:${error.code}`); console.info(`Failed to getting real time. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get real time. message:${e.message}, code:${e.code}`); console.info(`Failed to get real time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -428,15 +428,15 @@ setDate(date: Date, callback: AsyncCallback&lt;void&gt;): void ...@@ -428,15 +428,15 @@ setDate(date: Date, callback: AsyncCallback&lt;void&gt;): void
```js ```js
let date = new Date(); let date = new Date();
try { try {
systemTime.setDate(date, (error) => { systemTime.setDate(date, (error) => {
if (error) { if (error) {
console.info(`Failed to setting date. message:${error.message}, code:${error.code}`); console.info(`Failed to setting date. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in setting date.`); console.info(`Succeeded in setting date.`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set date. message:${e.message}, code:${e.code}`); console.info(`Failed to set date. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -467,13 +467,13 @@ setDate(date: Date): Promise&lt;void&gt; ...@@ -467,13 +467,13 @@ setDate(date: Date): Promise&lt;void&gt;
```js ```js
let date = new Date(); let date = new Date();
try { try {
systemTime.setDate(date).then(() => { systemTime.setDate(date).then(() => {
console.info(`Succeeded in setting date.`); console.info(`Succeeded in setting date.`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to setting date. message:${error.message}, code:${error.code}`); console.info(`Failed to setting date. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set date. message:${e.message}, code:${e.code}`); console.info(`Failed to set date. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -499,15 +499,15 @@ getDate(callback: AsyncCallback&lt;Date&gt;): void ...@@ -499,15 +499,15 @@ getDate(callback: AsyncCallback&lt;Date&gt;): void
```js ```js
try { try {
systemTime.getDate((error, date) => { systemTime.getDate((error, date) => {
if (error) { if (error) {
console.info(`Failed to get date. message:${error.message}, code:${error.code}`); console.info(`Failed to get date. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in get date : ${date}`);; console.info(`Succeeded in get date : ${date}`);;
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get date. message:${e.message}, code:${e.code}`); console.info(`Failed to get date. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -533,13 +533,13 @@ getDate(): Promise&lt;Date&gt; ...@@ -533,13 +533,13 @@ getDate(): Promise&lt;Date&gt;
```js ```js
try { try {
systemTime.getDate().then((date) => { systemTime.getDate().then((date) => {
console.info(`Succeeded in getting date : ${date}`); console.info(`Succeeded in getting date : ${date}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to getting date. message:${error.message}, code:${error.code}`); console.info(`Failed to getting date. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get date. message:${e.message}, code:${e.code}`); console.info(`Failed to get date. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -564,15 +564,15 @@ setTimezone(timezone: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -564,15 +564,15 @@ setTimezone(timezone: string, callback: AsyncCallback&lt;void&gt;): void
```js ```js
try { try {
systemTime.setTimezone('Asia/Shanghai', (error) => { systemTime.setTimezone('Asia/Shanghai', (error) => {
if (error) { if (error) {
console.info(`Failed to setting timezone. message:${error.message}, code:${error.code}`); console.info(`Failed to setting timezone. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in setting timezone.`); console.info(`Succeeded in setting timezone.`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set timezone. message:${e.message}, code:${e.code}`); console.info(`Failed to set timezone. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -602,13 +602,13 @@ setTimezone(timezone: string): Promise&lt;void&gt; ...@@ -602,13 +602,13 @@ setTimezone(timezone: string): Promise&lt;void&gt;
```js ```js
try { try {
systemTime.setTimezone('Asia/Shanghai').then(() => { systemTime.setTimezone('Asia/Shanghai').then(() => {
console.info(`Succeeded in setting timezone.`); console.info(`Succeeded in setting timezone.`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to setting timezone. message:${error.message}, code:${error.code}`); console.info(`Failed to setting timezone. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to set timezone. message:${e.message}, code:${e.code}`); console.info(`Failed to set timezone. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -634,15 +634,15 @@ getTimezone(callback: AsyncCallback&lt;string&gt;): void ...@@ -634,15 +634,15 @@ getTimezone(callback: AsyncCallback&lt;string&gt;): void
```js ```js
try { try {
systemTime.getTimezone((error, data) => { systemTime.getTimezone((error, data) => {
if (error) { if (error) {
console.info(`Failed to get timezone. message:${error.message}, code:${error.code}`); console.info(`Failed to get timezone. message: ${error.message}, code: ${error.code}`);
return; return;
} }
console.info(`Succeeded in get timezone : ${data}`);; console.info(`Succeeded in get timezone : ${data}`);;
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get timezone. message:${e.message}, code:${e.code}`); console.info(`Failed to get timezone. message: ${e.message}, code: ${e.code}`);
} }
``` ```
...@@ -654,7 +654,7 @@ getTimezone(): Promise&lt;string&gt; ...@@ -654,7 +654,7 @@ getTimezone(): Promise&lt;string&gt;
> **说明:** > **说明:**
> >
> 从 API Version 7 开始支持,从 API Version 9 开始废弃,建议使用[systemDateTime.getTimezone](#syste./js-apis-system-date-time.md#systemdatetimegettimezone-1)替代。 > 从 API Version 7 开始支持,从 API Version 9 开始废弃,建议使用[systemDateTime.getTimezone](./js-apis-system-date-time.md#systemdatetimegettimezone-1)替代。
**系统能力:** SystemCapability.MiscServices.Time **系统能力:** SystemCapability.MiscServices.Time
...@@ -668,13 +668,13 @@ getTimezone(): Promise&lt;string&gt; ...@@ -668,13 +668,13 @@ getTimezone(): Promise&lt;string&gt;
```js ```js
try { try {
systemTime.getTimezone().then((data) => { systemTime.getTimezone().then((data) => {
console.info(`Succeeded in getting timezone: ${data}`); console.info(`Succeeded in getting timezone: ${data}`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to getting timezone. message:${error.message}, code:${error.code}`); console.info(`Failed to getting timezone. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to get timezone. message:${e.message}, code:${e.code}`); console.info(`Failed to get timezone. message: ${e.message}, code: ${e.code}`);
} }
``` ```
......
...@@ -63,23 +63,23 @@ createTimer(options: TimerOptions, callback: AsyncCallback&lt;number&gt;): void ...@@ -63,23 +63,23 @@ createTimer(options: TimerOptions, callback: AsyncCallback&lt;number&gt;): void
```js ```js
export default { export default {
systemTimer () { systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat: false repeat: false
}; };
try { try {
systemTimer.createTimer(options, (error) => { systemTimer.createTimer(options, (error, timerId) => {
if (error) { if (error) {
console.info(`Failed to create timer. message:${error.message}, code:${error.code}`); console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
return; return;
}
console.info(`Succeeded in creating timer.`);
});
} catch(e) {
console.info(`Failed to create timer. message:${e.message}, code:${e.code}`);
} }
console.info(`Succeeded in creating timer. timerId:` + timerId);
});
} catch(e) {
console.info(`Failed to create timer. message: ${e.message}, code: ${e.code}`);
} }
}
} }
``` ```
...@@ -109,21 +109,21 @@ createTimer(options: TimerOptions): Promise&lt;number&gt; ...@@ -109,21 +109,21 @@ createTimer(options: TimerOptions): Promise&lt;number&gt;
```js ```js
export default { export default {
systemTimer () { systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
}; };
try { try {
systemTimer.createTimer(options).then(() => { systemTimer.createTimer(options).then((timerId) => {
console.info(`Succeeded in creating timer.`); console.info(`Succeeded in creating timer. timerId:` + timerId);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to create timer. message:${error.message}, code:${error.code}`); console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to create timer. message:${e.message}, code:${e.code}`); console.info(`Failed to create timer. message: ${e.message}, code: ${e.code}`);
}
} }
}
} }
``` ```
...@@ -149,26 +149,26 @@ startTimer(timer: number, triggerTime: number, callback: AsyncCallback&lt;void&g ...@@ -149,26 +149,26 @@ startTimer(timer: number, triggerTime: number, callback: AsyncCallback&lt;void&g
```js ```js
export default { export default {
async systemTimer () { async systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
}
let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime();
triggerTime += 3000;
try {
systemTimer.startTimer(timerId, triggerTime, (error) => {
if (error) {
console.info(`Failed to start timer. message: ${error.message}, code: ${error.code}`);
return;
} }
let timerId = await systemTimer.createTimer(options) console.info(`Succeeded in starting timer.`);
let triggerTime = new Date().getTime() });
triggerTime += 3000 } catch(e) {
try { console.info(`Failed to start timer. message: ${e.message}, code: ${e.code}`);
systemTimer.startTimer(timerId, triggerTime, (error) => {
if (error) {
console.info(`Failed to start timer. message:${error.message}, code:${error.code}`);
return;
}
console.info(`Succeeded in starting timer.`);
});
} catch(e) {
console.info(`Failed to start timer. message:${e.message}, code:${e.code}`);
}
} }
}
} }
``` ```
...@@ -199,24 +199,24 @@ startTimer(timer: number, triggerTime: number): Promise&lt;void&gt; ...@@ -199,24 +199,24 @@ startTimer(timer: number, triggerTime: number): Promise&lt;void&gt;
```js ```js
export default { export default {
async systemTimer (){ async systemTimer (){
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
}
let timerId = await systemTimer.createTimer(options)
let triggerTime = new Date().getTime()
triggerTime += 3000
try {
systemTimer.startTimer(timerId, triggerTime).then(() => {
console.info(`Succeeded in starting timer.`);
}).catch((error) => {
console.info(`Failed to start timer. message:${error.message}, code:${error.code}`);
});
} catch(e) {
console.info(`Failed to start timer. message:${e.message}, code:${e.code}`);
}
} }
let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime();
triggerTime += 3000;
try {
systemTimer.startTimer(timerId, triggerTime).then(() => {
console.info(`Succeeded in starting timer.`);
}).catch((error) => {
console.info(`Failed to start timer. message: ${error.message}, code: ${error.code}`);
});
} catch(e) {
console.info(`Failed to start timer. message: ${e.message}, code: ${e.code}`);
}
}
} }
``` ```
...@@ -241,27 +241,27 @@ stopTimer(timer: number, callback: AsyncCallback&lt;void&gt;): void ...@@ -241,27 +241,27 @@ stopTimer(timer: number, callback: AsyncCallback&lt;void&gt;): void
```js ```js
export default { export default {
async systemTimer () { async systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options) let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime() let triggerTime = new Date().getTime();
triggerTime += 3000 triggerTime += 3000;
systemTimer.startTimer(timerId, triggerTime) systemTimer.startTimer(timerId, triggerTime);
try { try {
systemTimer.stopTimer(timerId, (error) => { systemTimer.stopTimer(timerId, (error) => {
if (error) { if (error) {
console.info(`Failed to stop timer. message:${error.message}, code:${error.code}`); console.info(`Failed to stop timer. message: ${error.message}, code: ${error.code}`);
return; return;
}
console.info(`Succeeded in stopping timer.`);
});
} catch(e) {
console.info(`Failed to stop timer. message:${e.message}, code:${e.code}`);
} }
} console.info(`Succeeded in stopping timer.`);
});
} catch(e) {
console.info(`Failed to stop timer. message: ${e.message}, code: ${e.code}`);
}
}
} }
``` ```
...@@ -291,25 +291,25 @@ stopTimer(timer: number): Promise&lt;void&gt; ...@@ -291,25 +291,25 @@ stopTimer(timer: number): Promise&lt;void&gt;
```js ```js
export default { export default {
async systemTimer (){ async systemTimer (){
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options) let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime() let triggerTime = new Date().getTime();
triggerTime += 3000 triggerTime += 3000;
systemTimer.startTimer(timerId, triggerTime) systemTimer.startTimer(timerId, triggerTime);
try { try {
systemTimer.stopTimer(timerId).then(() => { systemTimer.stopTimer(timerId).then(() => {
console.info(`Succeeded in stopping timer.`); console.info(`Succeeded in stopping timer.`);
}).catch((error) => { }).catch((error) => {
console.info(`Failed to stop timer. message:${error.message}, code:${error.code}`); console.info(`Failed to stop timer. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
console.info(`Failed to stop timer. message:${e.message}, code:${e.code}`); console.info(`Failed to stop timer. message: ${e.message}, code: ${e.code}`);
}
} }
}
} }
``` ```
...@@ -334,28 +334,28 @@ destroyTimer(timer: number, callback: AsyncCallback&lt;void&gt;): void ...@@ -334,28 +334,28 @@ destroyTimer(timer: number, callback: AsyncCallback&lt;void&gt;): void
```js ```js
export default { export default {
async systemTimer () { async systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options) let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime() let triggerTime = new Date().getTime();
triggerTime += 3000 triggerTime += 3000;
systemTimer.startTimer(timerId, triggerTime) systemTimer.startTimer(timerId, triggerTime);
systemTimer.stopTimer(timerId) systemTimer.stopTimer(timerId);
try { try {
systemTimer.destroyTimer(timerId, (error) => { systemTimer.destroyTimer(timerId, (error) => {
if (error) { if (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}`);
return; return;
}
console.info(`Succeeded in destroying timer.`);
});
} catch(e) {
console.info(`Failed to destroying timer. message:${e.message}, code:${e.code}`);
} }
console.info(`Succeeded in destroying timer.`);
});
} catch(e) {
console.info(`Failed to destroying timer. message: ${e.message}, code: ${e.code}`);
} }
}
} }
``` ```
...@@ -385,25 +385,25 @@ destroyTimer(timer: number): Promise&lt;void&gt; ...@@ -385,25 +385,25 @@ destroyTimer(timer: number): Promise&lt;void&gt;
```js ```js
export default { export default {
async systemTimer (){ async systemTimer (){
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options) let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime() let triggerTime = new Date().getTime();
triggerTime += 3000 triggerTime += 3000;
systemTimer.startTimer(timerId, triggerTime) systemTimer.startTimer(timerId, triggerTime);
systemTimer.stopTimer(timerId) systemTimer.stopTimer(timerId);
try { try {
systemTimer.destroyTimer(timerId).then(() => { systemTimer.destroyTimer(timerId).then(() => {
console.info(`Succeeded in destroying timer.`); console.info(`Succeeded in destroying timer.`);
}).catch((error) => { }).catch((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) {
console.info(`Failed to destroying timer. message:${e.message}, code:${e.code}`); console.info(`Failed to destroying timer. message: ${e.message}, code: ${e.code}`);
}
} }
}
} }
``` ```
\ No newline at end of file
# 时间时区子系统ChangeLog
## cl.time.1 接口异常抛出变更
时间时区子系统时间相关接口异常抛出:201权限否定异常、202非系统应用异常和401参数无效异常。
**变更影响**
基于此前版本开发的应用,继续使用无影响,使用新接口需要捕获并处理抛出的新异常。
**关键接口/组件变更**
变更前:
- 接口异常抛出message,错误码-1。
变更后:
- 接口异常抛出message和code,包括201权限否定异常、202非系统应用异常和401参数无效异常。
原接口中标记为废弃的接口,可以使用新接口中的同名接口替换
| 原接口 | 新接口 |
| ---------------- | -------------------- |
| @ohos.systemTime | @ohos.systemDateTime |
**适配指导**
应用中调用systemTime所有接口可参考下列代码进行异常捕获,以setTime接口为例,其他接口适配方法相同。
callback形式调用:
**示例:**
```js
import systemDateTime from @ohos.systemDateTime
// time对应的时间为2021-01-20 02:36:25
let time = 1611081385000;
try {
systemDateTime.setTime(time, (error) => {
//捕获权限否定异常和非系统应用异常
if (error) {
console.info(`Failed to setting time. message:${error.message}, code:${error.code}`);
return;
}
console.info(`Succeeded in setting time.`);
})
} catch(e) {
//捕获参数校验失败异常
console.info(`Failed to set time. message:${e.message}, code:${e.code}`);
}
```
promise形式调用:
**示例:**
```js
import systemDateTime from @ohos.systemDateTime
// time对应的时间为2021-01-20 02:36:25
let time = 1611081385000;
try {
systemDateTime.setTime(time).then(() => {
console.info(`Succeeded in setting time.`);
}).catch((error) => {
//捕获权限否定异常和非系统应用异常
console.info(`Failed to setting time. message:${error.message}, code:${error.code}`);
});
} catch(e) {
//捕获参数校验失败异常
console.info(`Failed to set time. message:${e.message}, code:${e.code}`);
}
```
...@@ -16,16 +16,16 @@ ...@@ -16,16 +16,16 @@
变更后: 变更后:
- 接口异常抛出message和code,包括202非系统应用异常和401参数无效异常。 - 接口异常抛出message和code,包括202非系统应用异常和401参数无效异常。
| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | | 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 |
| ----------------- | ----------- | ------------------------------------------------------------ | -------- | | ----------------- | ----------- | ------------------------------------------------------------ | -------- |
| @ohos.systemTimer | systemTimer | function createTimer(options: TimerOptions, callback: AsyncCallback<number>): void | 变更 | | @ohos.systemTimer | systemTimer | function createTimer(options: TimerOptions, callback: AsyncCallback<number>): void | 变更 |
| @ohos.systemTimer | systemTimer | function createTimer(options: TimerOptions): Promise<number> | 变更 | | @ohos.systemTimer | systemTimer | function createTimer(options: TimerOptions): Promise<number> | 变更 |
| @ohos.systemTimer | systemTimer | function startTimer(timer: number, triggerTime: number, callback: AsyncCallback<void>): void | 变更 | | @ohos.systemTimer | systemTimer | function startTimer(timer: number, triggerTime: number, callback: AsyncCallback<void>): void | 变更 |
| @ohos.systemTimer | systemTimer | function startTimer(timer: number, triggerTime: number): Promise<void> | 变更 | | @ohos.systemTimer | systemTimer | function startTimer(timer: number, triggerTime: number): Promise<void> | 变更 |
| @ohos.systemTimer | systemTimer | function stopTimer(timer: number, callback: AsyncCallback<void>): void | 变更 | | @ohos.systemTimer | systemTimer | function stopTimer(timer: number, callback: AsyncCallback<void>): void | 变更 |
| @ohos.systemTimer | systemTimer | function stopTimer(timer: number): Promise<void> | 变更 | | @ohos.systemTimer | systemTimer | function stopTimer(timer: number): Promise<void> | 变更 |
| @ohos.systemTimer | systemTimer | function destroyTimer(timer: number, callback: AsyncCallback<void>): void | 变更 | | @ohos.systemTimer | systemTimer | function destroyTimer(timer: number, callback: AsyncCallback<void>): void | 变更 |
| @ohos.systemTimer | systemTimer | function destroyTimer(timer: number): Promise<void> | 变更 | | @ohos.systemTimer | systemTimer | function destroyTimer(timer: number): Promise<void> | 变更 |
**适配指导** **适配指导**
...@@ -38,23 +38,24 @@ createTimer callback形式调用: ...@@ -38,23 +38,24 @@ createTimer callback形式调用:
```js ```js
export default { export default {
systemTimer () { systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat: false repeat: false
}; };
try { try {
systemTimer.createTimer(options, (error, data) => { systemTimer.createTimer(options, (error, timerId) => {
if (error) { if (error) {
//捕获权限否定异常 //捕获权限否定异常
console.info(`Failed to create timer. message:${error.message}, code:${error.code}`); console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}
});
} catch(e) {
//捕获参数校验失败异常
console.info(`Failed to create timer. message:${e.message}, code:${e.code}`);
} }
console.info(`Succeeded in creating timer. timerId:` + timerId);
});
} catch(e) {
//捕获参数校验失败异常
console.info(`Failed to create timer. message: ${e.message}, code: ${e.code}`);
} }
}
} }
``` ```
...@@ -64,23 +65,23 @@ createTimer promise形式调用: ...@@ -64,23 +65,23 @@ createTimer promise形式调用:
```js ```js
export default { export default {
systemTimer () { systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat: false repeat: false
}; };
try { try {
systemTimer.createTimer(options).then((data) => { systemTimer.createTimer(options).then((timerId) => {
console.info(`Succeeded in creating timer. Data:` + data); console.info(`Succeeded in creating timer. timerId:` + timerId);
}).catch((error) => { }).catch((error) => {
//捕获权限否定异常 //捕获权限否定异常
console.info(`Failed to create timer. message:${error.message}, code:${error.code}`); console.info(`Failed to create timer. message: ${error.message}, code: ${error.code}`);
}); });
} catch(e) { } catch(e) {
//捕获参数校验失败异常 //捕获参数校验失败异常
console.info(`Failed to create timer. message:${e.message}, code:${e.code}`); console.info(`Failed to create timer. message: ${e.message}, code: ${e.code}`);
}
} }
}
} }
``` ```
...@@ -90,26 +91,26 @@ startTimer callback形式调用: ...@@ -90,26 +91,26 @@ startTimer callback形式调用:
```js ```js
export default { export default {
async systemTimer () { async systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options); let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime(); let triggerTime = new Date().getTime();
triggerTime += 3000; triggerTime += 3000;
try { try {
systemTimer.startTimer(timerId, triggerTime, (error) => { systemTimer.startTimer(timerId, triggerTime, (error) => {
if (error) { if (error) {
//捕获权限否定异常 //捕获权限否定异常
console.error(`Failed to start timer. message:${error.message}, code:${error.code}`); console.error(`Failed to start timer. message: ${error.message}, code: ${error.code}`);
}
});
} catch (e) {
//捕获参数校验失败异常
console.info(`Failed to start timer. message:${e.message}, code:${e.code}`);
} }
});
} catch (e) {
//捕获参数校验失败异常
console.info(`Failed to start timer. message: ${e.message}, code: ${e.code}`);
} }
}
} }
``` ```
...@@ -119,26 +120,26 @@ startTimer promise形式调用: ...@@ -119,26 +120,26 @@ startTimer promise形式调用:
```js ```js
export default { export default {
async systemTimer (){ async systemTimer (){
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options); let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime(); let triggerTime = new Date().getTime();
triggerTime += 3000; triggerTime += 3000;
try { try {
systemTimer.startTimer(timerId, triggerTime).then((data) => { systemTimer.startTimer(timerId, triggerTime).then((data) => {
console.log(`Succeeded in startting timer. Data:` + data); console.log(`Succeeded in startting timer. Data:` + data);
}).catch((error) => { }).catch((error) => {
//捕获权限否定异常 //捕获权限否定异常
console.info(`Failed to start timer. message:${error.message}, code:${error.code}`); console.info(`Failed to start timer. message: ${error.message}, code: ${error.code}`);
}); });
} catch (e) { } catch (e) {
//捕获参数校验失败异常 //捕获参数校验失败异常
console.info(`Failed to start timer. message:${e.message}, code:${e.code}`); console.info(`Failed to start timer. message: ${e.message}, code: ${e.code}`);
}
} }
}
} }
``` ```
...@@ -148,27 +149,27 @@ stopTimer callback形式调用: ...@@ -148,27 +149,27 @@ stopTimer callback形式调用:
```js ```js
export default { export default {
async systemTimer () { async systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options); let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime(); let triggerTime = new Date().getTime();
triggerTime += 3000; triggerTime += 3000;
systemTimer.startTimer(timerId, triggerTime); systemTimer.startTimer(timerId, triggerTime);
try { try {
systemTimer.stopTimer(timerId, triggerTime, (error) => { systemTimer.stopTimer(timerId, triggerTime, (error) => {
if (error) { if (error) {
//捕获权限否定异常 //捕获权限否定异常
console.error(`Failed to stop timer. message:${error.message}, code:${error.code}`); console.error(`Failed to stop timer. message: ${error.message}, code: ${error.code}`);
}
});
} catch (e) {
//捕获参数校验失败异常
console.info(`Failed to stop timer. message:${e.message}, code:${e.code}`);
} }
});
} catch (e) {
//捕获参数校验失败异常
console.info(`Failed to stop timer. message: ${e.message}, code: ${e.code}`);
} }
}
} }
``` ```
...@@ -178,27 +179,27 @@ stopTimer promise形式调用: ...@@ -178,27 +179,27 @@ stopTimer promise形式调用:
```js ```js
export default { export default {
async systemTimer (){ async systemTimer (){
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options); let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime(); let triggerTime = new Date().getTime();
triggerTime += 3000; triggerTime += 3000;
systemTimer.startTimer(timerId, triggerTime); systemTimer.startTimer(timerId, triggerTime);
try { try {
systemTimer.stopTimer(timerId, triggerTime).then((data) => { systemTimer.stopTimer(timerId, triggerTime).then((data) => {
console.log(`Succeeded in stop timer. Data:` + data); console.log(`Succeeded in stop timer. Data:` + data);
}).catch((error) => { }).catch((error) => {
//捕获权限否定异常 //捕获权限否定异常
console.info(`Failed to stop timer. message:${error.message}, code:${error.code}`); console.info(`Failed to stop timer. message: ${error.message}, code: ${error.code}`);
}); });
} catch (e) { } catch (e) {
//捕获参数校验失败异常 //捕获参数校验失败异常
console.info(`Failed to stop timer. message:${e.message}, code:${e.code}`); console.info(`Failed to stop timer. message: ${e.message}, code: ${e.code}`);
}
} }
}
} }
``` ```
...@@ -208,28 +209,28 @@ destroyTimer callback形式调用: ...@@ -208,28 +209,28 @@ destroyTimer callback形式调用:
```js ```js
export default { export default {
async systemTimer () { async systemTimer () {
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options); let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime(); let triggerTime = new Date().getTime();
triggerTime += 3000; triggerTime += 3000;
systemTimer.startTimer(timerId, triggerTime); systemTimer.startTimer(timerId, triggerTime);
systemTimer.stopTimer(timerId); systemTimer.stopTimer(timerId);
try { try {
systemTimer.destroyTimer(timerId, triggerTime, (error) => { systemTimer.destroyTimer(timerId, triggerTime, (error) => {
if (error) { if (error) {
//捕获权限否定异常 //捕获权限否定异常
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) {
//捕获参数校验失败异常
console.info(`Failed to destroy timer. message:${e.message}, code:${e.code}`);
} }
});
} catch (e) {
//捕获参数校验失败异常
console.info(`Failed to destroy timer. message: ${e.message}, code: ${e.code}`);
} }
}
} }
``` ```
...@@ -239,28 +240,97 @@ destroyTimer promise形式调用: ...@@ -239,28 +240,97 @@ destroyTimer promise形式调用:
```js ```js
export default { export default {
async systemTimer (){ async systemTimer (){
let options = { let options = {
type: systemTimer.TIMER_TYPE_REALTIME, type: systemTimer.TIMER_TYPE_REALTIME,
repeat:false repeat:false
} }
let timerId = await systemTimer.createTimer(options); let timerId = await systemTimer.createTimer(options);
let triggerTime = new Date().getTime(); let triggerTime = new Date().getTime();
triggerTime += 3000; triggerTime += 3000;
systemTimer.startTimer(timerId, triggerTime); systemTimer.startTimer(timerId, triggerTime);
systemTimer.stopTimer(timerId); systemTimer.stopTimer(timerId);
try { try {
systemTimer.destroyTimer(timerId, triggerTime).then((data) => { systemTimer.destroyTimer(timerId, triggerTime).then((data) => {
console.log(`Succeeded in destroy timer. Data:` + data); console.log(`Succeeded in destroy timer. Data:` + data);
}).catch((error) => { }).catch((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) {
//捕获参数校验失败异常 //捕获参数校验失败异常
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 接口异常抛出变更
时间时区子系统时间相关接口异常抛出:201权限否定异常、202非系统应用异常和401参数无效异常。
**变更影响**
基于此前版本开发的应用,继续使用无影响,使用新接口需要捕获并处理抛出的新异常。
**关键接口/组件变更**
变更前:
- 接口异常抛出message,错误码-1。
变更后:
- 接口异常抛出message和code,包括201权限否定异常、202非系统应用异常和401参数无效异常。
原接口中标记为废弃的接口,可以使用新接口中的同名接口替换
| 原接口 | 新接口 |
| ---------------- | -------------------- |
| @ohos.systemTime | @ohos.systemDateTime |
**适配指导**
应用中调用systemTime所有接口可参考下列代码进行异常捕获,以setTime接口为例,其他接口适配方法相同。
callback形式调用:
**示例:**
```js
import systemDateTime from @ohos.systemDateTime
// time对应的时间为2021-01-20 02:36:25
let time = 1611081385000;
try {
systemDateTime.setTime(time, (error) => {
//捕获权限否定异常和非系统应用异常
if (error) {
console.info(`Failed to setting time. message: ${error.message}, code: ${error.code}`);
return;
} }
console.info(`Succeeded in setting time.`);
})
} catch(e) {
//捕获参数校验失败异常
console.info(`Failed to set time. message: ${e.message}, code: ${e.code}`);
} }
``` ```
promise形式调用:
**示例:**
```js
import systemDateTime from @ohos.systemDateTime
// time对应的时间为2021-01-20 02:36:25
let time = 1611081385000;
try {
systemDateTime.setTime(time).then(() => {
console.info(`Succeeded in setting time.`);
}).catch((error) => {
//捕获权限否定异常和非系统应用异常
console.info(`Failed to setting time. message: ${error.message}, code: ${error.code}`);
});
} catch(e) {
//捕获参数校验失败异常
console.info(`Failed to set time. message: ${e.message}, code: ${e.code}`);
}
```
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册