1# @ohos.reminderAgent (后台代理提醒) 2 3本模块提供后台代理提醒的能力。 4 5开发应用时，开发者可以调用后台提醒发布的接口创建定时提醒，包括倒计时、日历、闹钟三种提醒类型。使用后台代理提醒能力后，应用可以被冻结或退出，计时和弹出提醒的功能将被后台系统服务代理。 6 7> **说明：** 8> 9> 从API Version 9 开始，该接口不再维护，推荐使用新接口[@ohos.reminderAgentManager (后台代理提醒)](js-apis-reminderAgentManager.md) 10> 11> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 12 13 14## 导入模块 15 16```js 17import reminderAgent from'@ohos.reminderAgent'; 18``` 19 20 21## reminderAgent.publishReminder<sup>(deprecated)</sup> 22 23publishReminder(reminderReq: ReminderRequest, callback: AsyncCallback<number>): void 24 25发布一个后台代理提醒，使用callback方式实现异步调用，该方法需要申请通知弹窗[Notification.requestEnableNotification](js-apis-notification.md#notificationrequestenablenotification8)后才能调用。 26 27> **说明：** 28> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.publishReminder](js-apis-reminderAgentManager.md#reminderagentmanagerpublishreminder)替代。 29 30**需要权限**： `ohos.permission.PUBLISH_AGENT_REMINDER` 31 32**系统能力**： SystemCapability.Notification.ReminderAgent 33 34**参数**： 35 36 | 参数名 | 类型 | 必填 | 说明 | 37 | -------- | -------- | -------- | -------- | 38 | reminderReq | [ReminderRequest](#reminderrequest) | 是 | 需要发布的提醒实例。 | 39 | callback | AsyncCallback<number> | 是 | 异步回调，返回当前发布的提醒的reminderId。 | 40 41**示例**： 42```js 43 let timer = { 44 reminderType: reminderAgent.ReminderType.REMINDER_TYPE_TIMER, 45 triggerTimeInSeconds: 10 46 } 47 reminderAgent.publishReminder(timer, (err, reminderId) => { 48 console.log("callback, reminderId = " + reminderId); 49 }); 50``` 51 52 53## reminderAgent.publishReminder<sup>(deprecated)</sup> 54 55publishReminder(reminderReq: ReminderRequest): Promise<number> 56 57发布一个后台代理提醒，使用Promise方式实现异步调用，该方法需要申请通知弹窗[Notification.requestEnableNotification](js-apis-notification.md#notificationrequestenablenotification8)后才能调用。 58 59> **说明：** 60> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.publishReminder](js-apis-reminderAgentManager.md#reminderagentmanagerpublishreminder-1)替代。 61 62**需要权限**： `ohos.permission.PUBLISH_AGENT_REMINDER` 63 64**系统能力**： SystemCapability.Notification.ReminderAgent 65 66**参数**： 67 | 参数名 | 类型 | 必填 | 说明 | 68 | -------- | -------- | -------- | -------- | 69 | reminderReq | [ReminderRequest](#reminderrequest) | 是 | 需要发布的提醒实例。 | 70 71**返回值**： 72 | 类型 | 说明 | 73 | -------- | -------- | 74 | Promise<number> | 返回提醒的reminderId。 | 75 76**示例**： 77```js 78 let timer = { 79 reminderType: reminderAgent.ReminderType.REMINDER_TYPE_TIMER, 80 triggerTimeInSeconds: 10 81 } 82 reminderAgent.publishReminder(timer).then((reminderId) => { 83 console.log("promise, reminderId = " + reminderId); 84 }); 85``` 86 87 88## reminderAgent.cancelReminder<sup>(deprecated)</sup> 89 90cancelReminder(reminderId: number, callback: AsyncCallback<void>): void 91 92取消指定id的提醒，使用callback方式实现异步调用。 93 94> **说明：** 95> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.cancelReminder](js-apis-reminderAgentManager.md#reminderagentmanagercancelreminder)替代。 96 97**系统能力**： `SystemCapability.Notification.ReminderAgent` 98 99**参数**： 100 101| 参数名 | 类型 | 必填 | 说明 | 102| -------- | -------- | -------- | -------- | 103| reminderId | number | 是 | 目标reminder的id号，[publishReminder](#reminderagentpublishreminder)方法调用成功后获得。 | 104| callback | AsyncCallback<void> | 是 | 异步回调。 | 105 106**示例**： 107 108```js 109reminderAgent.cancelReminder(1, (err, data) => { 110 console.log("cancelReminder callback"); 111}); 112``` 113 114 115## reminderAgent.cancelReminder<sup>(deprecated)</sup> 116 117cancelReminder(reminderId: number): Promise\<void> 118 119取消指定id的提醒，使用Promise方式实现异步调用。 120 121> **说明：** 122> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.cancelReminder](js-apis-reminderAgentManager.md#reminderagentmanagercancelreminder-1)替代。 123 124**系统能力**： `SystemCapability.Notification.ReminderAgent` 125 126**参数**： 127 128| 参数名 | 类型 | 必填 | 说明 | 129| -------- | -------- | -------- | -------- | 130| reminderId | number | 是 | 目标reminder的id号，[publishReminder](#reminderagentpublishreminder)方法调用成功后获得。 | 131 132**返回值**： 133 134| 类型 | 说明 | 135| -------- | -------- | 136| Promise<void> | Promise类型异步回调。 | 137 138**示例**： 139 140```js 141reminderAgent.cancelReminder(1).then(() => { 142 console.log("cancelReminder promise"); 143}); 144``` 145 146## reminderAgent.getValidReminders<sup>(deprecated)</sup> 147 148getValidReminders(callback: AsyncCallback\<Array\<ReminderRequest>>): void 149 150获取当前应用已设置的所有有效（未过期）的提醒，使用callback方式实现异步调用。 151 152> **说明：** 153> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.getValidReminders](js-apis-reminderAgentManager.md#reminderagentmanagergetvalidreminders)替代。 154 155**系统能力**： `SystemCapability.Notification.ReminderAgent` 156 157**参数**： 158 159| 参数名 | 类型 | 必填 | 说明 | 160| -------- | -------- | -------- | -------- | 161| callback | AsyncCallback<Array<[ReminderRequest](#reminderrequest)>> | 是 | 异步回调，返回当前应用已设置的所有有效（未过期）的提醒。 | 162 163**示例**： 164 165```js 166reminderAgent.getValidReminders((err, reminders) => { 167 console.log("callback, getValidReminders length = " + reminders.length); 168 for (let i = 0; i < reminders.length; i++) { 169 console.log("getValidReminders = " + reminders[i]); 170 console.log("getValidReminders, reminderType = " + reminders[i].reminderType); 171 for (let j = 0; j < reminders[i].actionButton.length; j++) { 172 console.log("getValidReminders, actionButton.title = " + reminders[i].actionButton[j].title); 173 console.log("getValidReminders, actionButton.type = " + reminders[i].actionButton[j].type); 174 } 175 console.log("getValidReminders, wantAgent.pkgName = " + reminders[i].wantAgent.pkgName); 176 console.log("getValidReminders, wantAgent.abilityName = " + reminders[i].wantAgent.abilityName); 177 console.log("getValidReminders, maxScreenWantAgent.pkgName = " + reminders[i].maxScreenWantAgent.pkgName); 178 console.log("getValidReminders, maxScreenWantAgent.abilityName = " + reminders[i].maxScreenWantAgent.abilityName); 179 console.log("getValidReminders, ringDuration = " + reminders[i].ringDuration); 180 console.log("getValidReminders, snoozeTimes = " + reminders[i].snoozeTimes); 181 console.log("getValidReminders, timeInterval = " + reminders[i].timeInterval); 182 console.log("getValidReminders, title = " + reminders[i].title); 183 console.log("getValidReminders, content = " + reminders[i].content); 184 console.log("getValidReminders, expiredContent = " + reminders[i].expiredContent); 185 console.log("getValidReminders, snoozeContent = " + reminders[i].snoozeContent); 186 console.log("getValidReminders, notificationId = " + reminders[i].notificationId); 187 console.log("getValidReminders, slotType = " + reminders[i].slotType); 188 } 189}) 190``` 191 192 193## reminderAgent.getValidReminders<sup>(deprecated)</sup> 194 195getValidReminders(): Promise\<Array\<ReminderRequest>> 196 197获取当前应用已设置的所有有效（未过期）的提醒，使用Promise方式实现异步调用。 198 199> **说明：** 200> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.getValidReminders](js-apis-reminderAgentManager.md#reminderagentmanagergetvalidreminders-1)替代。 201 202**系统能力**： `SystemCapability.Notification.ReminderAgent` 203 204**返回值**： 205 206| 类型 | 说明 | 207| -------- | -------- | 208| Promise<Array<[ReminderRequest](#reminderrequest)>> | 返回当前应用已设置的所有有效（未过期）的提醒。 | 209 210**示例**： 211 212```js 213reminderAgent.getValidReminders().then((reminders) => { 214 console.log("promise, getValidReminders length = " + reminders.length); 215 for (let i = 0; i < reminders.length; i++) { 216 console.log("getValidReminders = " + reminders[i]); 217 console.log("getValidReminders, reminderType = " + reminders[i].reminderType); 218 for (let j = 0; j < reminders[i].actionButton.length; j++) { 219 console.log("getValidReminders, actionButton.title = " + reminders[i].actionButton[j].title); 220 console.log("getValidReminders, actionButton.type = " + reminders[i].actionButton[j].type); 221 } 222 console.log("getValidReminders, wantAgent.pkgName = " + reminders[i].wantAgent.pkgName); 223 console.log("getValidReminders, wantAgent.abilityName = " + reminders[i].wantAgent.abilityName); 224 console.log("getValidReminders, maxScreenWantAgent.pkgName = " + reminders[i].maxScreenWantAgent.pkgName); 225 console.log("getValidReminders, maxScreenWantAgent.abilityName = " + reminders[i].maxScreenWantAgent.abilityName); 226 console.log("getValidReminders, ringDuration = " + reminders[i].ringDuration); 227 console.log("getValidReminders, snoozeTimes = " + reminders[i].snoozeTimes); 228 console.log("getValidReminders, timeInterval = " + reminders[i].timeInterval); 229 console.log("getValidReminders, title = " + reminders[i].title); 230 console.log("getValidReminders, content = " + reminders[i].content); 231 console.log("getValidReminders, expiredContent = " + reminders[i].expiredContent); 232 console.log("getValidReminders, snoozeContent = " + reminders[i].snoozeContent); 233 console.log("getValidReminders, notificationId = " + reminders[i].notificationId); 234 console.log("getValidReminders, slotType = " + reminders[i].slotType); 235 } 236}) 237``` 238 239 240## reminderAgent.cancelAllReminders<sup>(deprecated)</sup> 241 242cancelAllReminders(callback: AsyncCallback<void>): void 243 244取消当前应用所有的提醒，使用callback方式实现异步调用。 245 246> **说明：** 247> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.cancelAllReminders](js-apis-reminderAgentManager.md#reminderagentmanagercancelallreminders)替代。 248 249**系统能力**： `SystemCapability.Notification.ReminderAgent` 250 251**参数**： 252 253| 参数名 | 类型 | 必填 | 说明 | 254| -------- | -------- | -------- | -------- | 255| callback | AsyncCallback<void> | 是 | 异步回调。 | 256 257**示例**： 258 259```js 260reminderAgent.cancelAllReminders((err, data) =>{ 261 console.log("cancelAllReminders callback") 262}) 263``` 264 265 266## reminderAgent.cancelAllReminders<sup>(deprecated)</sup> 267 268cancelAllReminders(): Promise\<void> 269 270取消当前应用所有的提醒，使用Promise方式实现异步调用。 271 272> **说明：** 273> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.cancelAllReminders](js-apis-reminderAgentManager.md#reminderagentmanagercancelallreminders-1)替代。 274 275**系统能力**： `SystemCapability.Notification.ReminderAgent` 276 277**返回值**： 278 279| 类型 | 说明 | 280| -------- | -------- | 281| Promise<void> | Promise类型异步回调。 | 282 283**示例**： 284 285```js 286reminderAgent.cancelAllReminders().then(() => { 287 console.log("cancelAllReminders promise") 288}) 289``` 290 291 292## reminderAgent.addNotificationSlot 293 294addNotificationSlot(slot: NotificationSlot, callback: AsyncCallback<void>): void 295 296添加一个NotificationSlot，使用callback方式实现异步调用。 297 298> **说明：** 299> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.addNotificationSlot](js-apis-reminderAgentManager.md#reminderagentmanageraddnotificationslot)替代。 300 301**系统能力**： `SystemCapability.Notification.ReminderAgent` 302 303**参数**： 304 305| 参数名 | 类型 | 必填 | 说明 | 306| -------- | -------- | -------- | -------- | 307| slot | [NotificationSlot](js-apis-notification.md#notificationslot) | 是 | notification slot实例，仅支持设置其type属性。 | 308| callback | AsyncCallback<void> | 是 | 异步回调。 | 309 310**示例**： 311 312```js 313import notification from '@ohos.notification' 314 315let mySlot = { 316 type: notification.SlotType.SOCIAL_COMMUNICATION 317} 318reminderAgent.addNotificationSlot(mySlot, (err, data) => { 319 console.log("addNotificationSlot callback"); 320}); 321``` 322 323 324## reminderAgent.addNotificationSlot<sup>(deprecated)</sup> 325 326addNotificationSlot(slot: NotificationSlot): Promise\<void> 327 328添加一个NotificationSlot，使用Promise方式实现异步调用。 329 330> **说明：** 331> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.addNotificationSlot](js-apis-reminderAgentManager.md#reminderagentmanageraddnotificationslot-1)替代。 332 333**系统能力**： `SystemCapability.Notification.ReminderAgent` 334 335**参数**： 336 337| 参数名 | 类型 | 必填 | 说明 | 338| -------- | -------- | -------- | -------- | 339| slot | [NotificationSlot](js-apis-notification.md#notificationslot) | 是 | notification slot实例，仅支持设置其type属性。 | 340 341**返回值**： 342 343| 类型 | 说明 | 344| -------- | -------- | 345| Promise<void> | Promise类型异步回调。 | 346 347**示例**： 348 349```js 350import notification from '@ohos.notification' 351 352let mySlot = { 353 type: notification.SlotType.SOCIAL_COMMUNICATION 354} 355reminderAgent.addNotificationSlot(mySlot).then(() => { 356 console.log("addNotificationSlot promise"); 357}); 358``` 359 360 361## reminderAgent.removeNotificationSlot<sup>(deprecated)</sup> 362 363removeNotificationSlot(slotType: notification.SlotType, callback: AsyncCallback<void>): void 364 365删除目标NotificationSlot，使用callback方式实现异步调用。 366 367> **说明：** 368> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#reminderagentmanagerremovenotificationslot)替代。 369 370**系统能力**： `SystemCapability.Notification.ReminderAgent` 371 372**参数**： 373 374| 参数名 | 类型 | 必填 | 说明 | 375| -------- | -------- | -------- | -------- | 376| slotType | [notification.SlotType](js-apis-notification.md#slottype) | 是 | 目标notification slot的类型。 | 377| callback | AsyncCallback<void> | 是 | 异步回调。 | 378 379**示例**： 380 381```js 382import notification from '@ohos.notification' 383 384reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION, (err, data) => { 385 console.log("removeNotificationSlot callback"); 386}); 387``` 388 389 390## reminderAgent.removeNotificationSlot<sup>(deprecated)</sup> 391 392removeNotificationSlot(slotType: notification.SlotType): Promise<void> 393 394删除目标NotificationSlot，使用Promise方式实现异步调用。 395 396> **说明：** 397> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.removeNotificationSlot](js-apis-reminderAgentManager.md#reminderagentmanagerremovenotificationslot-1)替代。 398 399**系统能力**： `SystemCapability.Notification.ReminderAgent` 400 401**参数**： 402 403| 参数名 | 类型 | 必填 | 说明 | 404| -------- | -------- | -------- | -------- | 405| slotType | [notification.SlotType](js-apis-notification.md#slottype) | 是 | 目标notification slot的类型。 | 406 407**返回值**： 408 409| 类型 | 说明 | 410| -------- | -------- | 411| Promise<void> | Promise类型异步回调。 | 412 413**示例**： 414 415```js 416import notification from '@ohos.notification' 417 418reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION).then(() => { 419 console.log("removeNotificationSlot promise"); 420}); 421``` 422 423 424## ActionButtonType<sup>(deprecated)</sup> 425 426按钮的类型。 427 428> **说明：** 429> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.ActionButtonType](js-apis-reminderAgentManager.md#ActionButtonType)替代。 430 431**系统能力**：`SystemCapability.Notification.ReminderAgent` 432 433| 名称 | 值 | 说明 | 434| -------- | -------- | -------- | 435| ACTION_BUTTON_TYPE_CLOSE | 0 | 表示关闭提醒的按钮。 | 436| ACTION_BUTTON_TYPE_SNOOZE | 1 | 表示延迟提醒的按钮。 | 437 438 439## ReminderType<sup>(deprecated)</sup> 440 441提醒的类型。 442 443> **说明：** 444> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.ReminderType](js-apis-reminderAgentManager.md#ReminderType)替代。 445 446**系统能力**：`SystemCapability.Notification.ReminderAgent` 447 448| 名称 | 值 | 说明 | 449| -------- | -------- | -------- | 450| REMINDER_TYPE_TIMER | 0 | 表示提醒类型：倒计时。 | 451| REMINDER_TYPE_CALENDAR | 1 | 表示提醒类型：日历。 | 452| REMINDER_TYPE_ALARM | 2 | 表示提醒类型：闹钟。 | 453 454 455## ActionButton<sup>(deprecated)</sup> 456 457用于设置弹出的提醒通知信息上显示的按钮类型和标题。 458 459> **说明：** 460> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.ActionButton](js-apis-reminderAgentManager.md#ActionButton)替代。 461 462**系统能力**：`SystemCapability.Notification.ReminderAgent` 463 464| 名称 | 类型 | 必填 | 说明 | 465| -------- | -------- | -------- | -------- | 466| title | string | 是 | 按钮显示的标题。 | 467| type | [ActionButtonType](#actionbuttontype) | 是 | 按钮的类型。 | 468 469 470## WantAgent<sup>(deprecated)</sup> 471 472点击提醒通知后跳转的目标ability信息。 473 474> **说明：** 475> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.WantAgent](js-apis-reminderAgentManager.md#WantAgent)替代。 476 477**系统能力**：`SystemCapability.Notification.ReminderAgent` 478 479| 名称 | 类型 | 必填 | 说明 | 480| -------- | -------- | -------- | -------- | 481| pkgName | string | 是 | 指明点击提醒通知栏后跳转的目标hap包名。 | 482| abilityName | string | 是 | 指明点击提醒通知栏后跳转的目标ability名称。 | 483 484 485## MaxScreenWantAgent<sup>(deprecated)</sup> 486 487全屏显示提醒到达时自动拉起的目标ability信息，该接口预留。 488 489> **说明：** 490> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.MaxScreenWantAgent](js-apis-reminderAgentManager.md#MaxScreenWantAgent)替代。 491 492**系统能力**：`SystemCapability.Notification.ReminderAgent` 493 494| 名称 | 类型 | 必填 | 说明 | 495| -------- | -------- | -------- | -------- | 496| pkgName | string | 是 | 指明提醒到达时自动拉起的目标hap包名（如果设备在使用中，则只弹出通知横幅框）。 | 497| abilityName | string | 是 | 指明提醒到达时自动拉起的目标ability名（如果设备在使用中，则只弹出通知横幅框）。 | 498 499 500## ReminderRequest<sup>(deprecated)</sup> 501 502提醒实例对象，用于设置提醒类型、响铃时长等具体信息。 503 504> **说明：** 505> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.ReminderRequest](js-apis-reminderAgentManager.md#ReminderRequest)替代。 506 507**系统能力**：`SystemCapability.Notification.ReminderAgent` 508 509| 名称 | 类型 | 必填 | 说明 | 510| -------- | -------- | -------- | -------- | 511| reminderType | [ReminderType](#remindertype) | 是 | 指明提醒类型。 | 512| actionButton | [ActionButton](#actionbutton) | 否 | 弹出的提醒通知栏中显示的按钮（参数可选，支持0/1/2个按钮）。 | 513| wantAgent | [WantAgent](#wantagent) | 否 | 点击通知后需要跳转的目标ability信息。 | 514| maxScreenWantAgent | [MaxScreenWantAgent](#maxscreenwantagent) | 否 | 提醒到达时跳转的目标包。如果设备正在使用中，则弹出一个通知框。 | 515| ringDuration | number | 否 | 指明响铃时长（单位：秒），默认1秒。 | 516| snoozeTimes | number | 否 | 指明延迟提醒次数，默认0次。 | 517| timeInterval | number | 否 | 执行延迟提醒间隔（单位：秒），默认0秒。 | 518| title | string | 否 | 指明提醒标题。 | 519| content | string | 否 | 指明提醒内容。 | 520| expiredContent | string | 否 | 指明提醒过期后需要显示的内容。 | 521| snoozeContent | string | 否 | 指明延迟提醒时需要显示的内容。 | 522| notificationId | number | 否 | 指明提醒使用的通知的id号，相同id号的提醒会覆盖。 | 523| slotType | [notification.SlotType](js-apis-notification.md#slottype) | 否 | 指明提醒的slot类型。 | 524 525 526## ReminderRequestCalendar<sup>(deprecated)</sup> 527 528ReminderRequestCalendar extends ReminderRequest 529 530日历实例对象，用于设置提醒的时间。 531 532> **说明：** 533> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.ReminderRequestCalendar](js-apis-reminderAgentManager.md#ReminderRequestCalendar)替代。 534 535**系统能力**：`SystemCapability.Notification.ReminderAgent` 536 537| 名称 | 类型 | 必填 | 说明 | 538| -------- | -------- | -------- | -------- | 539| dateTime | [LocalDateTime](#localdatetime) | 是 | 指明提醒的目标时间。 | 540| repeatMonths | Array<number> | 否 | 指明重复提醒的月份。 | 541| repeatDays | Array<number> | 否 | 指明重复提醒的日期。 | 542 543 544## ReminderRequestAlarm<sup>(deprecated)</sup> 545 546ReminderRequestAlarm extends ReminderRequest 547 548闹钟实例对象，用于设置提醒的时间。 549 550> **说明：** 551> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.ReminderRequestAlarm](js-apis-reminderAgentManager.md#ReminderRequestAlarm)替代。 552 553**系统能力**：`SystemCapability.Notification.ReminderAgent` 554 555| 名称 | 类型 | 必填 | 说明 | 556| -------- | -------- | -------- | -------- | 557| hour | number | 是 | 指明提醒的目标时刻。 | 558| minute | number | 是 | 指明提醒的目标分钟。 | 559| daysOfWeek | Array<number> | 否 | 指明每周哪几天需要重复提醒。范围为周一到周末，对应数字为1到7。 | 560 561 562## ReminderRequestTimer<sup>(deprecated)</sup> 563 564ReminderRequestTimer extends ReminderRequest 565 566倒计时实例对象，用于设置提醒的时间。 567 568> **说明：** 569> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.ReminderRequestTimer](js-apis-reminderAgentManager.md#ReminderRequestTimer)替代。 570 571**系统能力**：`SystemCapability.Notification.ReminderAgent` 572 573| 名称 | 类型 | 必填 | 说明 | 574| -------- | -------- | -------- | -------- | 575| triggerTimeInSeconds | number | 是 | 指明倒计时的秒数。 | 576 577 578## LocalDateTime<sup>(deprecated)</sup> 579 580用于日历类提醒设置时指定时间信息。 581 582> **说明：** 583> 从 API version 7开始支持，从API version 9开始废弃。建议使用[reminderAgentManager.LocalDateTime](js-apis-reminderAgentManager.md#LocalDateTime)替代。 584 585**系统能力**：`SystemCapability.Notification.ReminderAgent` 586 587| 名称 | 类型 | 必填 | 说明 | 588| -------- | -------- | -------- | -------- | 589| year | number | 是 | 年 | 590| month | number | 是 | 月 | 591| day | number | 是 | 日 | 592| hour | number | 是 | 时 | 593| minute | number | 是 | 分 | 594| second | number | 否 | 秒 | 595