• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.reminderAgentManager (Agent-Powered Reminders)
2
3The **reminderAgentManager** module provides APIs related to agent-powered reminders. When your application is frozen or exits, the timing and notification functions of your application will be taken over by a system service running in the background. You can use the APIs to create scheduled reminders for countdown timers, calendar events, and alarm clocks.
4
5> **NOTE**
6>
7> The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
8
9
10## Modules to Import
11
12```ts
13import reminderAgentManager from'@ohos.reminderAgentManager';
14```
15
16## reminderAgentManager.publishReminder
17
18publishReminder(reminderReq: ReminderRequest, callback: AsyncCallback\<number>): void
19
20Publishes a reminder. This API uses an asynchronous callback to return the result.
21
22> **NOTE**
23>
24> This API can be called only after the [Notification.requestEnableNotification](js-apis-notification.md#notificationrequestenablenotification8) permission is obtained.
25
26**Required permissions**: ohos.permission.PUBLISH_AGENT_REMINDER
27
28**System capability**: SystemCapability.Notification.ReminderAgent
29
30**Parameters**
31
32  | Name| Type| Mandatory| Description|
33  | -------- | -------- | -------- | -------- |
34  | reminderReq | [ReminderRequest](#reminderrequest) | Yes| Request used for publishing the reminder.|
35  | callback | AsyncCallback\<number> | Yes| Callback used to return the published reminder's ID.|
36
37**Error codes**
38
39For details about the error codes, see [reminderAgentManager Error Codes](../errorcodes/errorcode-reminderAgentManager.md).
40
41| ID  | Error Message|
42| --------- | ------- |
43| 1700001    | Notification is not enabled. |
44| 1700002    | The number of reminders exceeds the limit. |
45
46**Example**
47```ts
48import { BusinessError } from '@ohos.base';
49
50let timer: reminderAgentManager.ReminderRequestTimer = {
51  reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_TIMER,
52  triggerTimeInSeconds: 10
53}
54
55reminderAgentManager.publishReminder(timer, (err: BusinessError, reminderId: number) => {
56  if (err) {
57    console.log("callback err code:" + err.code + " message:" + err.message);
58  } else {
59    console.log("callback, reminderId = " + reminderId);
60  }
61});
62```
63
64## reminderAgentManager.publishReminder
65
66publishReminder(reminderReq: ReminderRequest): Promise\<number>
67
68Publishes a reminder. This API uses a promise to return the result.
69
70> **NOTE**
71>
72> This API can be called only after the [Notification.requestEnableNotification](js-apis-notification.md#notificationrequestenablenotification8) permission is obtained.
73
74**Required permissions**: ohos.permission.PUBLISH_AGENT_REMINDER
75
76**System capability**: SystemCapability.Notification.ReminderAgent
77
78**Parameters**
79  | Name| Type| Mandatory| Description|
80  | -------- | -------- | -------- | -------- |
81  | reminderReq | [ReminderRequest](#reminderrequest) | Yes| Request used for publishing the reminder.|
82
83**Return value**
84  | Type| Description|
85  | -------- | -------- |
86  | Promise\<number> | Promise used to return the published reminder's ID.|
87
88**Error codes**
89
90For details about the error codes, see [reminderAgentManager Error Codes](../errorcodes/errorcode-reminderAgentManager.md).
91
92| ID  | Error Message|
93| --------- | ------- |
94| 1700001    | Notification is not enabled. |
95| 1700002    | The number of reminders exceeds the limit. |
96
97**Example**
98```ts
99import { BusinessError } from '@ohos.base';
100
101let timer: reminderAgentManager.ReminderRequestTimer = {
102  reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_TIMER,
103  triggerTimeInSeconds: 10
104}
105
106reminderAgentManager.publishReminder(timer).then((reminderId: number) => {
107  console.log("promise, reminderId = " + reminderId);
108}).catch((err: BusinessError) => {
109  console.log("promise err code:" + err.code + " message:" + err.message);
110});
111```
112
113
114## reminderAgentManager.cancelReminder
115
116cancelReminder(reminderId: number, callback: AsyncCallback\<void>): void
117
118Cancels a reminder published. This API uses an asynchronous callback to return the result.
119
120**System capability**: SystemCapability.Notification.ReminderAgent
121
122**Parameters**
123
124| Name| Type| Mandatory| Description|
125| -------- | -------- | -------- | -------- |
126| reminderId | number | Yes| ID of the reminder to cancel.|
127| callback | AsyncCallback\<void> | Yes| Callback used to return the result. If the reminder is canceled, **err** is **undefined**. Otherwise, **err** is an error object.|
128
129**Error codes**
130
131For details about the error codes, see [reminderAgentManager Error Codes](../errorcodes/errorcode-reminderAgentManager.md).
132
133| ID  | Error Message|
134| --------- | ------- |
135| 1700003    | The reminder does not exist. |
136| 1700004    | The bundle name does not exist. |
137
138**Example**
139
140```ts
141import { BusinessError } from '@ohos.base';
142
143let reminderId: number = 1;
144reminderAgentManager.cancelReminder(reminderId, (err: BusinessError, data: void) => {
145  if (err) {
146    console.log("callback err code:" + err.code + " message:" + err.message);
147  } else {
148    console.log("cancelReminder callback");
149  }
150});
151```
152
153## reminderAgentManager.cancelReminder
154
155cancelReminder(reminderId: number): Promise\<void>
156
157Cancels a reminder published. This API uses a promise to return the result.
158
159**System capability**: SystemCapability.Notification.ReminderAgent
160
161**Parameters**
162
163| Name| Type| Mandatory| Description|
164| -------- | -------- | -------- | -------- |
165| reminderId | number | Yes| ID of the reminder to cancel.|
166
167**Return value**
168
169| Type| Description|
170| -------- | -------- |
171| Promise\<void> | Promise that returns no value.|
172
173**Error codes**
174
175For details about the error codes, see [reminderAgentManager Error Codes](../errorcodes/errorcode-reminderAgentManager.md).
176
177| ID  | Error Message|
178| --------- | ------- |
179| 1700003    | The reminder does not exist. |
180| 1700004    | The bundle name does not exist. |
181
182**Example**
183
184```ts
185import { BusinessError } from '@ohos.base';
186
187let reminderId: number = 1;
188reminderAgentManager.cancelReminder(reminderId).then(() => {
189  console.log("cancelReminder promise");
190}).catch((err: BusinessError) => {
191  console.log("promise err code:" + err.code + " message:" + err.message);
192});
193```
194
195## reminderAgentManager.getValidReminders
196
197getValidReminders(callback: AsyncCallback<Array\<ReminderRequest>>): void
198
199Obtains all valid (not yet expired) reminders set by the current application. This API uses an asynchronous callback to return the result.
200
201**System capability**: SystemCapability.Notification.ReminderAgent
202
203**Parameters**
204
205| Name| Type| Mandatory| Description|
206| -------- | -------- | -------- | -------- |
207| callback | AsyncCallback\<Array\<[ReminderRequest](#reminderrequest)>> | Yes| Callback used to return all the valid reminders.|
208
209**Error codes**
210
211For details about the error codes, see [reminderAgentManager Error Codes](../errorcodes/errorcode-reminderAgentManager.md).
212
213| ID  | Error Message|
214| --------- | ------- |
215| 1700004    | The bundle name does not exist. |
216
217**Example**
218
219```ts
220import { BusinessError } from '@ohos.base';
221
222reminderAgentManager.getValidReminders((err: BusinessError, reminders: Array<reminderAgentManager.ReminderRequest>) => {
223  if (err) {
224    console.log("callback err code:" + err.code + " message:" + err.message);
225  } else {
226    console.log("callback, getValidReminders length = " + reminders.length);
227    for (let i = 0; i < reminders.length; i++) {
228      console.log("getValidReminders = " + reminders[i]);
229      console.log("getValidReminders, reminderType = " + reminders[i].reminderType);
230      const actionButton = reminders[i].actionButton || [];
231      for (let j = 0; j < actionButton.length; j++) {
232        console.log("getValidReminders, actionButton.title = " + actionButton[j]?.title);
233        console.log("getValidReminders, actionButton.type = " + actionButton[j]?.type);
234      }
235      console.log("getValidReminders, wantAgent.pkgName = " + reminders[i].wantAgent?.pkgName);
236      console.log("getValidReminders, wantAgent.abilityName = " + reminders[i].wantAgent?.abilityName);
237      console.log("getValidReminders, maxScreenWantAgent.pkgName = " + reminders[i].maxScreenWantAgent?.pkgName);
238      console.log("getValidReminders, maxScreenWantAgent.abilityName = " + reminders[i].maxScreenWantAgent?.abilityName);
239      console.log("getValidReminders, ringDuration = " + reminders[i].ringDuration);
240      console.log("getValidReminders, snoozeTimes = " + reminders[i].snoozeTimes);
241      console.log("getValidReminders, timeInterval = " + reminders[i].timeInterval);
242      console.log("getValidReminders, title = " + reminders[i].title);
243      console.log("getValidReminders, content = " + reminders[i].content);
244      console.log("getValidReminders, expiredContent = " + reminders[i].expiredContent);
245      console.log("getValidReminders, snoozeContent = " + reminders[i].snoozeContent);
246      console.log("getValidReminders, notificationId = " + reminders[i].notificationId);
247      console.log("getValidReminders, slotType = " + reminders[i].slotType);
248    }
249  }
250});
251```
252
253## reminderAgentManager.getValidReminders
254
255getValidReminders(): Promise\<Array\<ReminderRequest>>
256
257Obtains all valid (not yet expired) reminders set by the current application. This API uses a promise to return the result.
258
259**System capability**: SystemCapability.Notification.ReminderAgent
260
261**Return value**
262
263| Type| Description|
264| -------- | -------- |
265| Promise\<Array\<[ReminderRequest](#reminderrequest)>> | Promise used to return all the valid reminders.|
266
267**Error codes**
268
269For details about the error codes, see [reminderAgentManager Error Codes](../errorcodes/errorcode-reminderAgentManager.md).
270
271| ID  | Error Message|
272| --------- | ------- |
273| 1700004    | The bundle name does not exist. |
274
275**Example**
276
277```ts
278import { BusinessError } from '@ohos.base';
279
280reminderAgentManager.getValidReminders().then((reminders: Array<reminderAgentManager.ReminderRequest>) => {
281  console.log("promise, getValidReminders length = " + reminders.length);
282  for (let i = 0; i < reminders.length; i++) {
283    console.log("getValidReminders = " + reminders[i]);
284    console.log("getValidReminders, reminderType = " + reminders[i].reminderType);
285    const actionButton = reminders[i].actionButton || [];
286    for (let j = 0; j < actionButton.length; j++) {
287      console.log("getValidReminders, actionButton.title = " + actionButton[j]?.title);
288      console.log("getValidReminders, actionButton.type = " + actionButton[j]?.type);
289    }
290    console.log("getValidReminders, wantAgent.pkgName = " + reminders[i].wantAgent?.pkgName);
291    console.log("getValidReminders, wantAgent.abilityName = " + reminders[i].wantAgent?.abilityName);
292    console.log("getValidReminders, maxScreenWantAgent.pkgName = " + reminders[i].maxScreenWantAgent?.pkgName);
293    console.log("getValidReminders, maxScreenWantAgent.abilityName = " + reminders[i].maxScreenWantAgent?.abilityName);
294    console.log("getValidReminders, ringDuration = " + reminders[i].ringDuration);
295    console.log("getValidReminders, snoozeTimes = " + reminders[i].snoozeTimes);
296    console.log("getValidReminders, timeInterval = " + reminders[i].timeInterval);
297    console.log("getValidReminders, title = " + reminders[i].title);
298    console.log("getValidReminders, content = " + reminders[i].content);
299    console.log("getValidReminders, expiredContent = " + reminders[i].expiredContent);
300    console.log("getValidReminders, snoozeContent = " + reminders[i].snoozeContent);
301    console.log("getValidReminders, notificationId = " + reminders[i].notificationId);
302    console.log("getValidReminders, slotType = " + reminders[i].slotType);
303  }
304}).catch((err: BusinessError) => {
305  console.log("promise err code:" + err.code + " message:" + err.message);
306});
307```
308
309## reminderAgentManager.cancelAllReminders
310
311cancelAllReminders(callback: AsyncCallback\<void>): void
312
313Cancels all reminders set by the current application. This API uses an asynchronous callback to return the result.
314
315**System capability**: SystemCapability.Notification.ReminderAgent
316
317**Parameters**
318
319| Name| Type| Mandatory| Description|
320| -------- | -------- | -------- | -------- |
321| callback | AsyncCallback\<void> | Yes| Callback used to return the result. If all the reminders are canceled, **err** is **undefined**. Otherwise, **err** is an error object. |
322
323**Error codes**
324
325For details about the error codes, see [reminderAgentManager Error Codes](../errorcodes/errorcode-reminderAgentManager.md).
326
327| ID  | Error Message|
328| --------- | ------- |
329| 1700004    | The bundle name does not exist. |
330
331**Example**
332
333```ts
334import { BusinessError } from '@ohos.base';
335
336reminderAgentManager.cancelAllReminders((err: BusinessError, data: void) =>{
337  if (err) {
338    console.log("callback err code:" + err.code + " message:" + err.message);
339  } else {
340    console.log("cancelAllReminders callback")
341  }
342});
343```
344
345## reminderAgentManager.cancelAllReminders
346
347cancelAllReminders(): Promise\<void>
348
349Cancels all reminders set by the current application. This API uses a promise to return the result.
350
351**System capability**: SystemCapability.Notification.ReminderAgent
352
353**Return value**
354
355| Type| Description|
356| -------- | -------- |
357| Promise\<void> | Promise that returns no value.|
358
359**Error codes**
360
361For details about the error codes, see [reminderAgentManager Error Codes](../errorcodes/errorcode-reminderAgentManager.md).
362
363| ID  | Error Message|
364| --------- | ------- |
365| 1700004    | The bundle name does not exist. |
366
367**Example**
368
369```ts
370import { BusinessError } from '@ohos.base';
371
372reminderAgentManager.cancelAllReminders().then(() => {
373  console.log("cancelAllReminders promise")
374}).catch((err: BusinessError) => {
375  console.log("promise err code:" + err.code + " message:" + err.message);
376});
377```
378
379
380## reminderAgentManager.addNotificationSlot
381
382addNotificationSlot(slot: NotificationSlot, callback: AsyncCallback\<void>): void
383
384Adds a notification slot. This API uses an asynchronous callback to return the result.
385
386**System capability**: SystemCapability.Notification.ReminderAgent
387
388**Parameters**
389
390| Name| Type| Mandatory| Description|
391| -------- | -------- | -------- | -------- |
392| slot | [NotificationSlot](js-apis-notification.md#notificationslot) | Yes| Notification slot. Only the type can be set.|
393| callback | AsyncCallback\<void> | Yes| Callback used to return the result. If the notification slot is added, **err** is **undefined**. Otherwise, **err** is an error object.|
394
395**Example**
396
397```ts
398import notification from '@ohos.notificationManager'
399import { BusinessError } from '@ohos.base';
400
401let mySlot: notification.NotificationSlot = {
402  type: notification.SlotType.SOCIAL_COMMUNICATION
403}
404
405reminderAgentManager.addNotificationSlot(mySlot, (err: BusinessError, data: void) => {
406  if (err) {
407    console.log("callback err code:" + err.code + " message:" + err.message);
408  } else {
409    console.log("addNotificationSlot callback");
410  }
411});
412```
413
414
415## reminderAgentManager.addNotificationSlot
416
417addNotificationSlot(slot: NotificationSlot): Promise\<void>
418
419Adds a notification slot. This API uses a promise to return the result.
420
421**System capability**: SystemCapability.Notification.ReminderAgent
422
423**Parameters**
424
425| Name| Type| Mandatory| Description|
426| -------- | -------- | -------- | -------- |
427| slot | [NotificationSlot](js-apis-notification.md#notificationslot) | Yes| Notification slot. Only the type can be set.|
428
429**Return value**
430
431| Type| Description|
432| -------- | -------- |
433| Promise\<void> | Promise that returns no value.|
434
435**Example**
436
437```ts
438import notification from '@ohos.notificationManager'
439import { BusinessError } from '@ohos.base';
440
441let mySlot: notification.NotificationSlot = {
442  type: notification.SlotType.SOCIAL_COMMUNICATION
443}
444reminderAgentManager.addNotificationSlot(mySlot).then(() => {
445  console.log("addNotificationSlot promise");
446}).catch((err: BusinessError) => {
447  console.log("promise err code:" + err.code + " message:" + err.message);
448});
449```
450
451
452## reminderAgentManager.removeNotificationSlot
453
454removeNotificationSlot(slotType: notification.SlotType, callback: AsyncCallback\<void>): void
455
456Removes a notification slot. This API uses an asynchronous callback to return the result.
457
458**System capability**: SystemCapability.Notification.ReminderAgent
459
460**Parameters**
461
462| Name| Type| Mandatory| Description|
463| -------- | -------- | -------- | -------- |
464| slotType | [notification.SlotType](js-apis-notification.md#slottype) | Yes| Type of the notification slot to remove.|
465| callback | AsyncCallback\<void> | Yes| Callback used to return the result. If the notification slot is removed, **err** is **undefined**. Otherwise, **err** is an error object.|
466
467**Example**
468
469```ts
470import notification from '@ohos.notificationManager'
471import { BusinessError } from '@ohos.base';
472
473reminderAgentManager.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION,
474  (err: BusinessError, data: void) => {
475  if (err) {
476    console.log("callback err code:" + err.code + " message:" + err.message);
477  } else {
478    console.log("removeNotificationSlot callback");
479  }
480});
481```
482
483
484## reminderAgentManager.removeNotificationSlot
485
486removeNotificationSlot(slotType: notification.SlotType): Promise\<void>
487
488Removes a notification slot. This API uses a promise to return the result.
489
490**System capability**: SystemCapability.Notification.ReminderAgent
491
492**Parameters**
493
494| Name| Type| Mandatory| Description|
495| -------- | -------- | -------- | -------- |
496| slotType | [notification.SlotType](js-apis-notification.md#slottype) | Yes| Type of the notification slot to remove.|
497
498**Return value**
499
500| Type| Description|
501| -------- | -------- |
502| Promise\<void> | Promise that returns no value.|
503
504**Example**
505
506```ts
507import notification from '@ohos.notificationManager'
508import { BusinessError } from '@ohos.base';
509
510reminderAgentManager.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION).then(() => {
511  console.log("removeNotificationSlot promise");
512}).catch((err: BusinessError) => {
513  console.log("promise err code:" + err.code + " message:" + err.message);
514});
515```
516
517## ActionButtonType
518
519Enumerates the button types.
520
521**System capability**: SystemCapability.Notification.ReminderAgent
522
523| Name| Value| Description|
524| -------- | -------- | -------- |
525| ACTION_BUTTON_TYPE_CLOSE | 0 | Button for closing the reminder.|
526| ACTION_BUTTON_TYPE_SNOOZE | 1 | Button for snoozing the reminder.|
527| ACTION_BUTTON_TYPE_CUSTOM<sup>10+</sup>  | 2 | Custom button.<br>**System API**: This is a system API and cannot be called by third-party applications.|
528
529
530## ReminderType
531
532Enumerates the reminder types.
533
534**System capability**: SystemCapability.Notification.ReminderAgent
535
536| Name| Value| Description|
537| -------- | -------- | -------- |
538| REMINDER_TYPE_TIMER | 0 | Countdown reminder.|
539| REMINDER_TYPE_CALENDAR | 1 | Calendar reminder.|
540| REMINDER_TYPE_ALARM | 2 | Alarm reminder.|
541
542
543## ActionButton
544
545Defines the button on the reminder displayed.
546
547**System capability**: SystemCapability.Notification.ReminderAgent
548
549| Name| Type| Mandatory| Description|
550| -------- | -------- | -------- | -------- |
551| title | string | Yes| Text on the button.|
552| type | [ActionButtonType](#actionbuttontype) | Yes| Button type.|
553| wantAgent<sup>10+</sup> | [WantAgent](#wantagent) | No| Information about the ability that is displayed after the button is clicked.<br>**System API**: This is a system API and cannot be called by third-party applications.|
554
555
556## WantAgent
557
558Defines the information about the redirected-to ability.
559
560**System capability**: SystemCapability.Notification.ReminderAgent
561
562
563| Name| Type| Mandatory| Description|
564| -------- | -------- | -------- | -------- |
565| pkgName | string | Yes| Name of the target package.|
566| abilityName | string | Yes| Name of the target ability.|
567| uri<sup>10+</sup> | string | No| URI of the target ability.<br>**System API**: This is a system API and cannot be called by third-party applications.|
568
569
570## MaxScreenWantAgent
571
572Provides the information about the ability that is started automatically and displayed in full-screen mode when the reminder arrives. This API is reserved.
573
574**System capability**: SystemCapability.Notification.ReminderAgent
575
576| Name| Type| Mandatory| Description|
577| -------- | -------- | -------- | -------- |
578| pkgName | string | Yes| Name of the target package. (If the device is in use, only a notification banner is displayed.)|
579| abilityName | string | Yes| Name of the target ability. (If the device is in use, only a notification banner is displayed.)|
580
581
582## ReminderRequest
583
584Defines the request for publishing a reminder.
585
586**System capability**: SystemCapability.Notification.ReminderAgent
587
588| Name| Type| Mandatory| Description|
589| -------- | -------- | -------- | -------- |
590| reminderType | [ReminderType](#remindertype) | Yes| Type of the reminder.|
591| actionButton<sup></sup> | [ActionButton](#actionbutton) | No| Buttons displayed for the reminder in the notification panel.<br>- For common applications, a maximum of two buttons are supported.<br>- For system applications, a maximum of two buttons are supported in API version 9, and a maximum of three buttons are supported in API version 10 and later versions.|
592| wantAgent | [WantAgent](#wantagent) | No| Information about the ability that is redirected to when the reminder is clicked.|
593| maxScreenWantAgent | [MaxScreenWantAgent](#maxscreenwantagent) | No| Information about the ability that is started automatically and displayed in full-screen mode when the reminder arrives. If the device is in use, only a notification banner is displayed.<br> This API is reserved.|
594| ringDuration | number | No| Ringing duration, in seconds. The default value is **1**.|
595| snoozeTimes | number | No| Number of reminder snooze times. The default value is **0**.|
596| timeInterval | number | No| Reminder snooze interval, in seconds. The minimum value is 5 minutes.|
597| title | string | No| Reminder title.|
598| content | string | No| Reminder content.|
599| expiredContent | string | No| Content to be displayed after the reminder expires.|
600| snoozeContent | string | No| Content to be displayed when the reminder is snoozing.|
601| notificationId | number | No| Notification ID used by the reminder. If there are reminders with the same notification ID, the later one will overwrite the earlier one.|
602| slotType | [notification.SlotType](js-apis-notificationManager.md#slottype) | No| Type of the slot used by the reminder.|
603| tapDismissed<sup>10+</sup> | boolean | No| Whether the reminder is automatically cleared. For details, see [NotificationRequest.tapDismissed](js-apis-inner-notification-notificationRequest.md#notificationrequest). |
604| autoDeletedTime<sup>10+</sup> | number | No| Time when the reminder is automatically cleared. For details, see [NotificationRequest.autoDeletedTime](js-apis-inner-notification-notificationRequest.md#notificationrequest).|
605
606
607## ReminderRequestCalendar
608
609ReminderRequestCalendar extends ReminderRequest
610
611Defines a reminder for a calendar event.
612
613**System capability**: SystemCapability.Notification.ReminderAgent
614
615| Name| Type| Mandatory| Description|
616| -------- | -------- | -------- | -------- |
617| dateTime | [LocalDateTime](#localdatetime) | Yes| Reminder time.|
618| repeatMonths | Array\<number> | No| Month in which the reminder repeats.|
619| repeatDays | Array\<number> | No| Date on which the reminder repeats.|
620
621
622## ReminderRequestAlarm
623
624ReminderRequestAlarm extends ReminderRequest
625
626Defines a reminder for an alarm.
627
628**System capability**: SystemCapability.Notification.ReminderAgent
629
630| Name| Type| Mandatory| Description|
631| -------- | -------- | -------- | -------- |
632| hour | number | Yes| Hour portion of the reminder time.|
633| minute | number | Yes| Minute portion of the reminder time.|
634| daysOfWeek | Array\<number> | No| Days of a week when the reminder repeats. The value ranges from 1 to 7, corresponding to the data from Monday to Sunday.|
635
636
637## ReminderRequestTimer
638
639ReminderRequestTimer extends ReminderRequest
640
641Defines a reminder for a scheduled timer.
642
643**System capability**: SystemCapability.Notification.ReminderAgent
644
645| Name| Type| Mandatory| Description|
646| -------- | -------- | -------- | -------- |
647| triggerTimeInSeconds | number | Yes| Number of seconds in the countdown timer.|
648
649
650## LocalDateTime
651
652Sets the time information for a calendar reminder.
653
654**System capability**: SystemCapability.Notification.ReminderAgent
655
656| Name| Type| Mandatory| Description|
657| -------- | -------- | -------- | -------- |
658| year | number | Yes| Year.|
659| month | number | Yes| Month. The value ranges from 1 to 12.|
660| day | number | Yes| Day. The value ranges from 1 to 31.|
661| hour | number | Yes| Hour. The value ranges from 0 to 23.|
662| minute | number | Yes| Minute. The value ranges from 0 to 59.|
663| second | number | No| Second. The value ranges from 0 to 59.|
664