js-apis-calendarManager.md 35.1 KB
Newer Older
Z
z00797030 已提交
1 2
# @ohos.calendarManager (日程管理能力)

Z
z00797030 已提交
3
本模块提供日历与日程管理能力,包括日历和日程的创建、删除、修改、查询等。日历[Calendar](#calendar)主要包含帐户信息[CalendarAccount](#calendaraccount)和配置信息[CalendarConfig](#calendarconfig)。日历Calendar与日程Event属于一对多关系,一个Calendar可以有多个Event,一个Event只属于一个Calendar。
Z
z00797030 已提交
4 5 6 7 8 9 10 11

> **说明:**
>
> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。


## 导入模块

Z
z00797030 已提交
12
```js
Z
z00797030 已提交
13
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
14 15 16 17 18
```


## calendarManager.createCalendar

Z
z00797030 已提交
19
createCalendar(calendarAccount: CalendarAccount, callback: AsyncCallback\<Calendar>): void
Z
z00797030 已提交
20

Z
z00797030 已提交
21
根据日历帐户信息,创建一个Calendar对象,使用callback异步回调。
Z
z00797030 已提交
22 23 24 25 26 27 28 29 30

**需要权限**: ohos.permission.WRITE_CALENDAR or ohos.permission.WRITE_WHOLE_CALENDAR

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

| 参数名          | 类型                                  | 必填 | 说明                               |
| --------------- | ------------------------------------- | ---- | ---------------------------------- |
Z
z00797030 已提交
31
| calendarAccount | [CalendarAccount](#calendaraccount)   | 是   | 日历帐户信息。                     |
Z
z00797030 已提交
32
| callback        | AsyncCallback\<[Calendar](#calendar)> | 是   | 回调函数,返回创建的Calendar对象。 |
Z
z00797030 已提交
33 34 35

**示例**

Z
z00797030 已提交
36
```js
Z
z00797030 已提交
37 38 39 40 41 42
let calendar = null;
const calendarAccount: calendarManager.CalendarAccount = {
  name: 'MyCalendar',
  type: calendarManager.CalendarType.LOCAL
};
calendarManager.createCalendar(calendarAccount, (err, data) => {
Z
z00797030 已提交
43
  if (err) {
Z
z00797030 已提交
44
    console.error("Failed to create calendar");
Z
z00797030 已提交
45
  } else {
Z
z00797030 已提交
46 47
    console.info("Succeeded in creating calendar");
    calendar = data;  
Z
z00797030 已提交
48 49 50 51 52 53
  }
});
```

## calendarManager.createCalendar

Z
z00797030 已提交
54
createCalendar(calendarAccount: CalendarAccount): Promise\<Calendar>
Z
z00797030 已提交
55

Z
z00797030 已提交
56
根据日历帐户信息,创建一个Calendar对象,使用Promise异步回调。
Z
z00797030 已提交
57 58 59 60 61 62 63 64 65

**需要权限**: ohos.permission.WRITE_CALENDAR or ohos.permission.WRITE_WHOLE_CALENDAR

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

| 参数名          | 类型                                | 必填 | 说明           |
| --------------- | ----------------------------------- | ---- | -------------- |
Z
z00797030 已提交
66
| calendarAccount | [CalendarAccount](#calendaraccount) | 是   | 日历帐户信息。 |
Z
z00797030 已提交
67 68 69

**返回值**

Z
z00797030 已提交
70 71 72
| 类型                           | 说明                                  |
| ------------------------------ | ------------------------------------- |
| Promise<[Calendar](#calendar)> | Promise对象,返回创建的Calendar对象。 |
Z
z00797030 已提交
73 74 75

**示例**

Z
z00797030 已提交
76
```js
Z
z00797030 已提交
77 78 79 80 81 82 83 84
let calendar = null;
const calendarAccount: calendarManager.CalendarAccount = {
  name: 'MyCalendar',
  type: calendarManager.CalendarType.LOCAL
};
calendarManager.createCalendar(calendarAccount).then((data) => {
  console.info("succeeded in creating calendar");
  calendar = data;
Z
z00797030 已提交
85
}).catch((err) => {
Z
z00797030 已提交
86
  console.error("Failed to create calendar");
Z
z00797030 已提交
87 88 89 90 91
});
```

## calendarManager.deleteCalendar

Z
z00797030 已提交
92
deleteCalendar(calendar: Calendar, callback: AsyncCallback\<void>): void
Z
z00797030 已提交
93

Z
z00797030 已提交
94
删除指定Calendar对象,使用callback异步回调。
Z
z00797030 已提交
95 96 97 98 99 100 101

**需要权限**: ohos.permission.WRITE_CALENDAR or ohos.permission.WRITE_WHOLE_CALENDAR

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
102 103 104 105
| 参数名   | 类型                  | 必填 | 说明           |
| -------- | --------------------- | ---- | -------------- |
| calendar | [Calendar](#calendar) | 是   | Calendar对象。 |
| callback | AsyncCallback\<void>  | 是   | 回调函数。     |
Z
z00797030 已提交
106 107 108

**示例**

Z
z00797030 已提交
109
```js
Z
z00797030 已提交
110 111 112 113 114
const calendarAccount: calendarManager.CalendarAccount = {
  name: 'MyCalendar',
  type: calendarManager.CalendarType.LOCAL
};
calendarManager.getCalendar(calendarAccount, (err, data) => {
Z
z00797030 已提交
115
  if (err) {
Z
z00797030 已提交
116
    console.error("Failed to get calendar");
Z
z00797030 已提交
117
  } else {
Z
z00797030 已提交
118 119 120 121 122 123 124 125
    console.info("Succeeded in getting calendar");
    calendarManager.deleteCalendar(data, (err) => {
      if (err) {
        console.error("Failed to delete calendar");
      } else {
        console.info("Succeeded in deleting calendar");
      }
    });
Z
z00797030 已提交
126 127 128 129 130 131
  }
});
```

## calendarManager.deleteCalendar

Z
z00797030 已提交
132
deleteCalendar(calendar: Calendar): Promise\<void>
Z
z00797030 已提交
133

Z
z00797030 已提交
134
删除指定Calendar对象,使用Promise异步回调。
Z
z00797030 已提交
135 136 137 138 139 140 141

**需要权限**: ohos.permission.WRITE_CALENDAR or ohos.permission.WRITE_WHOLE_CALENDAR

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
142 143 144
| 参数名   | 类型                  | 必填 | 说明           |
| -------- | --------------------- | ---- | -------------- |
| calendar | [Calendar](#calendar) | 是   | Calendar对象。 |
Z
z00797030 已提交
145 146 147

**返回值**

Z
z00797030 已提交
148 149 150
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
151 152 153

**示例**

Z
z00797030 已提交
154
```js
Z
z00797030 已提交
155 156 157 158 159 160 161 162 163 164 165
const calendarAccount: calendarManager.CalendarAccount = {
  name: 'MyCalendar',
  type: calendarManager.CalendarType.LOCAL
};
calendarManager.getCalendar(calendarAccount).then((data) => {
  console.info("Succeeded in getting calendar");
  calendarManager.deleteCalendar(data).then(() => {
    console.info("Succeeded in deleting calendar");
  }).catch((err) => {
    console.error("Failed to delete calendar");
  });
Z
z00797030 已提交
166
}).catch((err) => {
Z
z00797030 已提交
167
  console.error("Failed to get calendar");
Z
z00797030 已提交
168 169 170 171 172
});
```

## calendarManager.getCalendar

Z
z00797030 已提交
173
getCalendar(callback: AsyncCallback\<Calendar>): void
Z
z00797030 已提交
174

Z
z00797030 已提交
175
获取默认Calendar对象,默认Calendar是初始化数据库时创建的,若创建Event时不关注其Calendar归属,无须通过[createCalendar()](#calendarmanagercreatecalendar)创建Calendar,直接使用默认Calendar,使用callback异步回调。
Z
z00797030 已提交
176 177 178 179 180 181 182

**需要权限**:ohos.permission.READ_CALENDAR or ohos.permission.READ_WHOLE_CALENDAR

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
183 184 185
| 参数名   | 类型                                 | 必填 | 说明                                 |
| -------- | ------------------------------------ | ---- | ------------------------------------ |
| callback | AsyncCallback<[Calendar](#calendar)> | 是   | 回调函数,返回查询到的Calendar对象。 |
Z
z00797030 已提交
186 187 188

**示例**

Z
z00797030 已提交
189
```js
Z
z00797030 已提交
190
let calendar = null;
Z
z00797030 已提交
191 192
calendarManager.getCalendar((err, data) => {
  if (err) {
Z
z00797030 已提交
193
    console.error("Failed to get calendar");
Z
z00797030 已提交
194
  } else {
Z
z00797030 已提交
195
    console.info("Succeeded in getting calendar");
Z
z00797030 已提交
196
    calendar = data;  
Z
z00797030 已提交
197 198 199 200 201 202
  }
});
```

## calendarManager.getCalendar

Z
z00797030 已提交
203
getCalendar(calendarAccount: CalendarAccount, callback: AsyncCallback\<Calendar>): void
Z
z00797030 已提交
204

Z
z00797030 已提交
205
获取指定Calendar对象,使用callback异步回调。
Z
z00797030 已提交
206 207 208 209 210 211 212

**需要权限**: ohos.permission.READ_CALENDAR or ohos.permission.READ_WHOLE_CALENDAR

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
213 214 215 216
| 参数名          | 类型                                 | 必填 | 说明                                 |
| --------------- | ------------------------------------ | ---- | ------------------------------------ |
| calendarAccount | [CalendarAccount](#calendaraccount)  | 是   | 日历帐户信息。                       |
| callback        | AsyncCallback<[Calendar](#calendar)> | 是   | 回调函数,返回查询到的Calendar对象。 |
Z
z00797030 已提交
217 218 219

**示例**

Z
z00797030 已提交
220
```js
Z
z00797030 已提交
221
let calendar = null;
Z
z00797030 已提交
222 223 224 225
const calendarAccount: calendarManager.CalendarAccount = {
  name: 'MyCalendar',
  type: calendarManager.CalendarType.LOCAL
};
Z
z00797030 已提交
226
calendarManager.getCalendar(calendarAccount, (err, data) => {
Z
z00797030 已提交
227
  if (err) {
Z
z00797030 已提交
228
    console.error("Failed to get calendar");
Z
z00797030 已提交
229
  } else {
Z
z00797030 已提交
230
    console.info("Succeeded in getting calendar");
Z
z00797030 已提交
231
    calendar = data;
Z
z00797030 已提交
232 233 234 235 236 237
  }
});
```

## calendarManager.getCalendar

Z
z00797030 已提交
238
getCalendar(calendarAccount?: CalendarAccount): Promise\<Calendar>
Z
z00797030 已提交
239

Z
z00797030 已提交
240
获取默认Calendar对象或者指定Calendar对象,使用Promise异步回调。
Z
z00797030 已提交
241 242 243 244 245 246 247

**需要权限**: ohos.permission.READ_CALENDAR or ohos.permission.READ_WHOLE_CALENDAR

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
248 249 250
| 参数名          | 类型                                | 必填 | 说明                                                         |
| --------------- | ----------------------------------- | ---- | ------------------------------------------------------------ |
| calendarAccount | [CalendarAccount](#calendaraccount) | 否   | 日历帐户信息,用来获取指定Calendar对象,不填时,表示获取默认Calendar对象。 |
Z
z00797030 已提交
251 252 253

**返回值**

Z
z00797030 已提交
254 255 256
| 类型                           | 说明                                    |
| ------------------------------ | --------------------------------------- |
| Promise<[Calendar](#calendar)> | Promise对象,返回查询到的Calendar对象。 |
Z
z00797030 已提交
257 258 259

**示例**

Z
z00797030 已提交
260
```js
Z
z00797030 已提交
261
let calendar = null;
Z
z00797030 已提交
262
calendarManager.getCalendar().then((data) => {
Z
z00797030 已提交
263
  console.info("Succeeded in getting calendar");
Z
z00797030 已提交
264
  calendar = data;
Z
z00797030 已提交
265
}).catch((err) => {
Z
z00797030 已提交
266
  console.error("Failed to get calendar");
Z
z00797030 已提交
267 268 269 270 271
});
```

## calendarManager.getAllCalendars

Z
z00797030 已提交
272
getAllCalendars(callback: AsyncCallback\<Calendar[]>): void
Z
z00797030 已提交
273

Z
z00797030 已提交
274
获取当前应用所有创建的Calendar对象以及默认Calendar对象,使用callback异步回调。
Z
z00797030 已提交
275

Z
z00797030 已提交
276
**需要权限**:ohos.permission.READ_CALENDAR or ohos.permission.READ_WHOLE_CALENDAR
Z
z00797030 已提交
277 278 279 280 281

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
282 283 284
| 参数名   | 类型                                   | 必填 | 说明                                      |
| -------- | -------------------------------------- | ---- | ----------------------------------------- |
| callback | AsyncCallback<[Calendar](#calendar)[]> | 是   | 回调函数, 返回查询到的Calendar对象数组。 |
Z
z00797030 已提交
285 286 287

**示例**

Z
z00797030 已提交
288
```js
Z
z00797030 已提交
289 290
calendarManager.getAllCalendars((err, data) => {
  if (err) {
Z
z00797030 已提交
291
    console.error("Failed to get all calendars");
Z
z00797030 已提交
292
  } else {
Z
z00797030 已提交
293
    console.info("Succeeded in getting all calendars");
Z
z00797030 已提交
294 295 296 297 298 299
  }
});
```

## calendarManager.getAllCalendars

Z
z00797030 已提交
300
getAllCalendars(): Promise\<Calendar[]>
Z
z00797030 已提交
301

Z
z00797030 已提交
302
获取当前应用所有创建的Calendar对象以及默认Calendar对象,使用Promise异步回调。
Z
z00797030 已提交
303

Z
z00797030 已提交
304
**需要权限**: ohos.permission.READ_CALENDAR or ohos.permission.WRITE_WHOLE_CALENDAR
Z
z00797030 已提交
305 306 307 308 309

**系统能力**: SystemCapability.Applications.CalendarData

**返回值**

Z
z00797030 已提交
310 311 312
| 类型                             | 说明                                        |
| -------------------------------- | ------------------------------------------- |
| Promise<[Calendar](#calendar)[]> | Promise对象,返回查询到的Calendar对象数组。 |
Z
z00797030 已提交
313 314 315

**示例**

Z
z00797030 已提交
316
```js
Z
z00797030 已提交
317
calendarManager.getAllCalendars().then((data) => {
Z
z00797030 已提交
318
  console.info("Succeeded in getting all calendars");
Z
z00797030 已提交
319
}).catch((err) => {
Z
z00797030 已提交
320
  console.error("Failed to get all calendars");
Z
z00797030 已提交
321 322 323 324 325
});
```

## Calendar

Z
z00797030 已提交
326
下列API示例中需先通过[createCalendar()](#calendarmanagercreatecalendar)[getCalendar()](#calendarmanagergetcalendar)中任一方法获取Calendar对象,再通过此对象调用对应方法,对该Calendar下的日程进行创建、删除、修改、查询等操作。
Z
z00797030 已提交
327

Z
z00797030 已提交
328 329 330 331
### 属性

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
332 333 334
| 名称 | 类型   | 只读 | 必填 | 说明     |
| ---- | ------ | ---- | ---- | -------- |
| id   | number | 是   | 是   | 帐户id。 |
Z
z00797030 已提交
335 336 337

### addEvent

Z
z00797030 已提交
338
addEvent(event: Event, callback: AsyncCallback\<number>): void
Z
z00797030 已提交
339

Z
z00797030 已提交
340
创建日程,入参[Event](#event)不填日程id,使用callback异步回调。
Z
z00797030 已提交
341 342 343 344 345

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
346 347
| 参数名   | 类型                   | 必填 | 说明                   |
| -------- | ---------------------- | ---- | ---------------------- |
Z
z00797030 已提交
348
| event    | [Event](#event)        | 是   | Event对象。            |
Z
z00797030 已提交
349
| callback | AsyncCallback\<number> | 是   | 回调函数,返回日程id。 |
Z
z00797030 已提交
350 351 352

**示例**

Z
z00797030 已提交
353
```js
Z
z00797030 已提交
354 355 356
const date = new Date();
const event: calendarManager.Event = {
  type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
357 358
  startTime: date.getTime(),
  endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
359 360 361
};
calendar.addEvent(event, (err, data) => {
  if (err) {
Z
z00797030 已提交
362
    console.error("Failed to add event");
Z
z00797030 已提交
363
  } else {
Z
z00797030 已提交
364
    console.info("Succeeded in adding event");
Z
z00797030 已提交
365 366 367 368 369 370
  }
});
```

### addEvent

Z
z00797030 已提交
371
addEvent(event: Event): Promise\<number>
Z
z00797030 已提交
372

Z
z00797030 已提交
373
创建日程,入参[Event](#event)不填日程id,使用Promise异步回调。
Z
z00797030 已提交
374 375 376 377 378

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
379 380 381
| 参数名 | 类型            | 必填 | 说明        |
| ------ | --------------- | ---- | ----------- |
| event  | [Event](#event) | 是   | Event对象。 |
Z
z00797030 已提交
382 383 384

**返回值**

Z
z00797030 已提交
385 386 387
| 类型             | 说明                        |
| ---------------- | --------------------------- |
| Promise\<number> | Promise对象,返回日程的id。 |
Z
z00797030 已提交
388 389 390

**示例**

Z
z00797030 已提交
391
```js
Z
z00797030 已提交
392 393 394
const date = new Date();
const event: calendarManager.Event = {
  type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
395 396
  startTime: date.getTime(),
  endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
397 398
};
calendar.addEvent(event).then((data) => {
Z
z00797030 已提交
399
  console.info("Succeeded in adding event");
Z
z00797030 已提交
400
}).catch((err) => {
Z
z00797030 已提交
401
  console.error("Failed to add event");
Z
z00797030 已提交
402 403 404 405 406
});
```

### addEvents

Z
z00797030 已提交
407
addEvents(events: Event[], callback: AsyncCallback\<void>): void
Z
z00797030 已提交
408

Z
z00797030 已提交
409
批量创建日程,入参[Event](#event)不填日程id,使用callback异步回调。
Z
z00797030 已提交
410 411 412 413 414

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
415 416 417 418
| 参数名   | 类型                 | 必填 | 说明            |
| -------- | -------------------- | ---- | --------------- |
| events   | [Event](#event)[]    | 是   | Event对象数组。 |
| callback | AsyncCallback\<void> | 是   | 回调函数。      |
Z
z00797030 已提交
419 420 421

**示例**

Z
z00797030 已提交
422
```js
Z
z00797030 已提交
423 424 425 426
const date = new Date();
const events: calendarManager.Event[] = [
  {
    type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
427 428
    startTime: date.getTime(),
    endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
429 430 431
  },
  {
    type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
432 433
    startTime: date.getTime(),
    endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
434 435
  }
];
Z
z00797030 已提交
436
calendar.addEvents(events, (err) => {
Z
z00797030 已提交
437
  if (err) {
Z
z00797030 已提交
438
    console.error("Failed to add events");
Z
z00797030 已提交
439
  } else {
Z
z00797030 已提交
440
    console.info("Succeeded in adding events");
Z
z00797030 已提交
441 442 443 444 445 446
  }
});
```

### addEvents

Z
z00797030 已提交
447
addEvents(events: Event[]): Promise\<void>
Z
z00797030 已提交
448

Z
z00797030 已提交
449
批量创建日程,入参[Event](#event)不填日程id,使用Promise异步回调。
Z
z00797030 已提交
450 451 452 453 454

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
455 456 457
| 参数名 | 类型              | 必填 | 说明            |
| ------ | ----------------- | ---- | --------------- |
| events | [Event](#event)[] | 是   | Event对象数组。 |
Z
z00797030 已提交
458 459 460

**返回值**

Z
z00797030 已提交
461 462 463
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
464 465 466

**示例**

Z
z00797030 已提交
467
```js
Z
z00797030 已提交
468 469 470 471
const date = new Date();
const events: calendarManager.Event[] = [
  {
    type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
472 473
    startTime: date.getTime(),
    endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
474 475 476
  },
  {
    type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
477 478
    startTime: date.getTime(),
    endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
479 480 481
  }
];
calendar.addEvents(events).then(() => {
Z
z00797030 已提交
482
  console.info("Succeeded in adding events");
Z
z00797030 已提交
483
}).catch((err) => {
Z
z00797030 已提交
484
  console.error("Failed to add events");
Z
z00797030 已提交
485 486 487 488 489
});
```

### deleteEvent

Z
z00797030 已提交
490
deleteEvent(id: number, callback: AsyncCallback\<void>): void
Z
z00797030 已提交
491

Z
z00797030 已提交
492
删除指定id的日程,使用callback异步回调。
Z
z00797030 已提交
493 494 495 496 497

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
498 499 500 501
| 参数名   | 类型                 | 必填 | 说明       |
| -------- | -------------------- | ---- | ---------- |
| id       | number               | 是   | 日程id。   |
| callback | AsyncCallback\<void> | 是   | 回调函数。 |
Z
z00797030 已提交
502 503 504

**示例**

Z
z00797030 已提交
505
```js
Z
z00797030 已提交
506
calendar.deleteEvent(1, (err) => {
Z
z00797030 已提交
507
  if (err) {
Z
z00797030 已提交
508
    console.error("Failed to delete event");
Z
z00797030 已提交
509
  } else {
Z
z00797030 已提交
510
    console.info("Succeeded in deleting event");
Z
z00797030 已提交
511 512 513 514 515 516
  }
});
```

### deleteEvent

Z
z00797030 已提交
517
deleteEvent(id: number): Promise\<void>
Z
z00797030 已提交
518

Z
z00797030 已提交
519
删除指定id的日程,使用Promise异步回调。
Z
z00797030 已提交
520 521 522 523 524 525 526 527 528 529 530

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

| 参数名 | 类型   | 必填 | 说明     |
| ------ | ------ | ---- | -------- |
| id     | number | 是   | 日程id。 |

**返回值**

Z
z00797030 已提交
531 532 533
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
534 535 536

**示例**

Z
z00797030 已提交
537
```js
Z
z00797030 已提交
538
calendar.deleteEvent(1).then(() => {
Z
z00797030 已提交
539
  console.info("Succeeded in deleting event");
Z
z00797030 已提交
540
}).catch((err) => {
Z
z00797030 已提交
541
  console.error("Failed to delete event");
Z
z00797030 已提交
542 543 544 545 546
});
```

### deleteEvents

Z
z00797030 已提交
547
deleteEvents(ids: number[], callback: AsyncCallback\<void>): void
Z
z00797030 已提交
548

Z
z00797030 已提交
549
根据日程id,批量删除日程,使用callback异步回调。
Z
z00797030 已提交
550 551 552 553 554

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
555 556 557 558
| 参数名   | 类型                 | 必填 | 说明         |
| -------- | -------------------- | ---- | ------------ |
| ids      | number[]             | 是   | 日程id数组。 |
| callback | AsyncCallback\<void> | 是   | 回调函数。   |
Z
z00797030 已提交
559 560 561

**示例**

Z
z00797030 已提交
562
```js
Z
z00797030 已提交
563
calendar.deleteEvents([1, 2], (err) => {
Z
z00797030 已提交
564
  if (err) {
Z
z00797030 已提交
565
    console.error("Failed to delete events");
Z
z00797030 已提交
566
  } else {
Z
z00797030 已提交
567
    console.info("Succeeded in deleting events");
Z
z00797030 已提交
568 569 570 571 572 573
  }
});
```

### deleteEvents

Z
z00797030 已提交
574
deleteEvents(ids: number[]): Promise\<void>
Z
z00797030 已提交
575

Z
z00797030 已提交
576
根据日程id,批量删除日程,使用Promise异步回调。
Z
z00797030 已提交
577 578 579 580 581 582 583 584 585 586 587

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

| 参数名 | 类型     | 必填 | 说明         |
| ------ | -------- | ---- | ------------ |
| ids    | number[] | 是   | 日程id数组。 |

**返回值**

Z
z00797030 已提交
588 589 590
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
591 592 593

**示例**

Z
z00797030 已提交
594
```js
Z
z00797030 已提交
595
calendar.deleteEvents([1, 2]).then(() => {
Z
z00797030 已提交
596
  console.info("Succeeded in deleting events");
Z
z00797030 已提交
597
}).catch((err) => {
Z
z00797030 已提交
598
  console.error("Failed to delete events");
Z
z00797030 已提交
599 600 601 602 603
});
```

### updateEvent

Z
z00797030 已提交
604
updateEvent(event: Event, callback: AsyncCallback\<void>): void
Z
z00797030 已提交
605

Z
z00797030 已提交
606
更新日程,使用callback异步回调。
Z
z00797030 已提交
607 608 609 610 611

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
612 613 614 615
| 参数名   | 类型                 | 必填 | 说明        |
| -------- | -------------------- | ---- | ----------- |
| event    | [Event](#event)      | 是   | Event对象。 |
| callback | AsyncCallback\<void> | 是   | 回调函数。  |
Z
z00797030 已提交
616 617 618

**示例**

Z
z00797030 已提交
619
```js
Z
z00797030 已提交
620 621 622 623 624
const date = new Date();
const event: calendarManager.Event = {
  id: 1,
  title: 'update',
  type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
625 626
  startTime: date.getTime(),
  endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
627
};
Z
z00797030 已提交
628
calendar.updateEvent(event, (err) => {
Z
z00797030 已提交
629
  if (err) {
Z
z00797030 已提交
630
    console.error("Failed to update event");
Z
z00797030 已提交
631
  } else {
Z
z00797030 已提交
632
    console.info("Succeeded in updating event");
Z
z00797030 已提交
633 634 635 636 637 638
  }
});
```

### updateEvent

Z
z00797030 已提交
639
updateEvent(event: Event): Promise\<void>
Z
z00797030 已提交
640

Z
z00797030 已提交
641
更新日程,使用Promise异步回调。
Z
z00797030 已提交
642 643 644 645 646

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
647 648 649
| 参数名 | 类型            | 必填 | 说明        |
| ------ | --------------- | ---- | ----------- |
| event  | [Event](#event) | 是   | Event对象。 |
Z
z00797030 已提交
650 651 652

**返回值**

Z
z00797030 已提交
653 654 655
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
656 657 658

**示例**

Z
z00797030 已提交
659
```js
Z
z00797030 已提交
660 661 662 663 664
const date = new Date();
const event: calendarManager.Event = {
  id: 1,
  title: 'update',
  type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
665 666
  startTime: date.getTime(),
  endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
667 668
};
calendar.updateEvent(event).then(() => {
Z
z00797030 已提交
669
  console.info("Succeeded in updating event");
Z
z00797030 已提交
670
}).catch((err) => {
Z
z00797030 已提交
671
  console.error("Failed to update event");
Z
z00797030 已提交
672 673 674 675 676
});
```

### getEvents

Z
z00797030 已提交
677
getEvents(callback: AsyncCallback\<Event[]>): void
Z
z00797030 已提交
678

Z
z00797030 已提交
679
查询Calendar下所有Event,使用callback异步回调。
Z
z00797030 已提交
680 681 682 683 684

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
685 686 687
| 参数名   | 类型                             | 必填 | 说明                              |
| -------- | -------------------------------- | ---- | --------------------------------- |
| callback | AsyncCallback<[Event](#event)[]> | 是   | 回调函数,返回的是Event对象数组。 |
Z
z00797030 已提交
688 689 690

**示例**

Z
z00797030 已提交
691
```js
Z
z00797030 已提交
692 693
calendar.getEvents((err, data) => {
  if (err) {
Z
z00797030 已提交
694
    console.error("Failed to get events");
Z
z00797030 已提交
695
  } else {
Z
z00797030 已提交
696
    console.info("Succeeded in getting events");
Z
z00797030 已提交
697 698 699 700 701 702
  }
});
```

### getEvents

Z
z00797030 已提交
703
getEvents(eventFilter: EventFilter, eventKey: (keyof Event)[], callback: AsyncCallback\<Event[]>):void
Z
z00797030 已提交
704

Z
z00797030 已提交
705
获取Calendar下符合查询条件的Event,使用callback异步回调。
Z
z00797030 已提交
706 707 708 709 710

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
711 712 713 714 715
| 参数名      | 类型                             | 必填 | 说明                              |
| ----------- | -------------------------------- | ---- | --------------------------------- |
| eventFilter | [EventFilter](#eventfilter)      | 是   | 查询条件。                        |
| eventKey    | (keyof [Event](#event))[]        | 是   | 查询字段。                        |
| callback    | AsyncCallback<[Event](#event)[]> | 是   | 回调函数,返回的是Event对象数组。 |
Z
z00797030 已提交
716 717 718

**示例**

Z
z00797030 已提交
719
```js
Z
z00797030 已提交
720
const filter = calendarManager.EventFilter.filterById([1, 2]);
Z
z00797030 已提交
721
const columns: (keyof calendarManager.Event)[] =  ['title', 'type', 'startTime', 'endTime'];
Z
z00797030 已提交
722 723
calendar.getEvents(filter, columns, (err, data) => {
  if (err) {
Z
z00797030 已提交
724
    console.error("Failed to get events");
Z
z00797030 已提交
725
  } else {
Z
z00797030 已提交
726
    console.info("Succeeded in getting events");
Z
z00797030 已提交
727 728 729 730 731 732
  }
});
```

### getEvents

Z
z00797030 已提交
733
getEvents(eventFilter?: EventFilter, eventKey?: (keyof Event)[]): Promise\<Event[]>
Z
z00797030 已提交
734

Z
z00797030 已提交
735
获取Calendar下符合查询条件的Event,使用Promise异步回调。
Z
z00797030 已提交
736 737 738 739 740

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
741 742 743 744
| 参数名      | 类型                        | 必填 | 说明       |
| ----------- | --------------------------- | ---- | ---------- |
| eventFilter | [EventFilter](#eventfilter) | 否   | 查询条件。 |
| eventKey    | (keyof [Event](#event))[]   | 否   | 查询字段。 |
Z
z00797030 已提交
745 746 747

**返回值**

Z
z00797030 已提交
748 749 750
| 类型                       | 说明                                |
| -------------------------- | ----------------------------------- |
| Promise<[Event](#event)[]> | Promise对象,返回日程配置信息数组。 |
Z
z00797030 已提交
751 752 753

**示例**

Z
z00797030 已提交
754
```js
Z
z00797030 已提交
755 756
const filter = calendarManager.EventFilter.filterByTitle('MyEvent');
calendar.getEvents(filter).then((data) => {
Z
z00797030 已提交
757
  console.info("Succeeded in getting events");
Z
z00797030 已提交
758
}).catch((err) => {
Z
z00797030 已提交
759
  console.error("Failed to get events");
Z
z00797030 已提交
760 761 762 763 764
});
```

### getConfig

Z
z00797030 已提交
765
getConfig(): CalendarConfig
Z
z00797030 已提交
766

Z
z00797030 已提交
767
获取日历配置信息。
Z
z00797030 已提交
768 769 770 771 772

**系统能力**: SystemCapability.Applications.CalendarData

**返回值**

Z
z00797030 已提交
773 774
| 类型                              | 说明           |
| --------------------------------- | -------------- |
Z
z00797030 已提交
775
| [CalendarConfig](#calendarconfig) | 日历配置信息。 |
Z
z00797030 已提交
776 777 778

**示例**

Z
z00797030 已提交
779
```js
Z
z00797030 已提交
780
const config = calendar.getConfig();
Z
z00797030 已提交
781
console.info("get config success");
Z
z00797030 已提交
782 783 784 785
```

### setConfig

Z
z00797030 已提交
786
setConfig(config: CalendarConfig, callback: AsyncCallback\<void>): void
Z
z00797030 已提交
787

Z
z00797030 已提交
788
设置日历配置信息,使用callback异步回调。
Z
z00797030 已提交
789 790 791 792 793

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
794 795 796 797
| 参数名   | 类型                              | 必填 | 说明           |
| -------- | --------------------------------- | ---- | -------------- |
| config   | [CalendarConfig](#calendarconfig) | 是   | 日历配置信息。 |
| callback | AsyncCallback\<void>              | 是   | 回调函数。     |
Z
z00797030 已提交
798 799 800

**示例**

Z
z00797030 已提交
801
```js
Z
z00797030 已提交
802 803 804
const config: calendarManager.CalendarConfig = {
  enableReminder: true
};
Z
z00797030 已提交
805
calendar.setConfig(config, (err) => {
Z
z00797030 已提交
806
  if (err) {
Z
z00797030 已提交
807
    console.error("Failed to set config");
Z
z00797030 已提交
808
  } else {
Z
z00797030 已提交
809
    console.info("Succeeded in setting config");
Z
z00797030 已提交
810 811 812 813 814 815
  }
});
```

### setConfig

Z
z00797030 已提交
816
setConfig(config: CalendarConfig): Promise\<void>
Z
z00797030 已提交
817

Z
z00797030 已提交
818
设置日历配置信息,使用Promise异步回调。
Z
z00797030 已提交
819 820 821 822 823

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

Z
z00797030 已提交
824 825 826
| 参数名 | 类型                              | 必填 | 说明           |
| ------ | --------------------------------- | ---- | -------------- |
| config | [CalendarConfig](#calendarconfig) | 是   | 日历配置信息。 |
Z
z00797030 已提交
827 828 829

**返回值**

Z
z00797030 已提交
830 831 832
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
833 834 835

**示例**

Z
z00797030 已提交
836
```js
Z
z00797030 已提交
837 838 839 840
const config: calendarManager.CalendarConfig = {
  enableReminder: true
};
calendar.setConfig(config).then(() => {
Z
z00797030 已提交
841
  console.info("Succeeded in setting config");
Z
z00797030 已提交
842
}).catch((err) => {
Z
z00797030 已提交
843
  console.error("Failed to set config");
Z
z00797030 已提交
844 845 846 847 848
});
```

### getAccount

Z
z00797030 已提交
849
getAccount(): CalendarAccount
Z
z00797030 已提交
850

Z
z00797030 已提交
851
获取日历账户信息。
Z
z00797030 已提交
852 853 854 855 856

**系统能力**: SystemCapability.Applications.CalendarData

**返回值**

Z
z00797030 已提交
857 858 859
| 类型                                | 说明           |
| ----------------------------------- | -------------- |
| [CalendarAccount](#calendaraccount) | 日历帐户信息。 |
Z
z00797030 已提交
860 861 862

**示例**

Z
z00797030 已提交
863
```js
Z
z00797030 已提交
864
const account = calendar.getAccount();
Z
z00797030 已提交
865
console.info("get account success");
Z
z00797030 已提交
866 867 868 869
```

## CalendarAccount

Z
z00797030 已提交
870
日历帐户信息。
Z
z00797030 已提交
871 872 873

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
874 875 876 877
| 名称        | 类型                          | 只读 | 必填 | 说明                                   |
| ----------- | ----------------------------- | ---- | ---- | -------------------------------------- |
| name        | string                        | 是   | 是   | 帐户名称。                             |
| type        | [CalendarType](#calendartype) | 否   | 是   | 帐户类型。                             |
Z
z00797030 已提交
878
| displayName | string                        | 否   | 否   | 帐户的显示名称。不填时,默认为空字符串。 |
Z
z00797030 已提交
879 880 881

## CalendarConfig

Z
z00797030 已提交
882
日历配置信息。
Z
z00797030 已提交
883 884 885

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
886 887 888
| 名称           | 类型                                                | 只读 | 必填 | 说明                                                         |
| -------------- | --------------------------------------------------- | ---- | ---- | ------------------------------------------------------------ |
| enableReminder | boolean                                             | 否   | 否   | 是否打开Calendar下所有Event提醒能力。当取值为true时,该Calendar下所有Event具备提醒能力;当取值为false时,不具备提醒能力,默认具备提醒能力。 |
Z
z00797030 已提交
889
| color          | [ResourceColor](../arkui-ts/ts-types.md#resourcecolor) | 否   | 否   | 设置Calendar颜色。不填时,默认值为'#0A59F7'。                |
Z
z00797030 已提交
890 891 892

## Event

Z
z00797030 已提交
893
日程对象,包含日程标题、开始时间、结束时间等信息。
Z
z00797030 已提交
894

Z
z00797030 已提交
895 896
**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
897 898
| 名称           | 类型                              | 只读 | 必填 | 说明                                                         |
| -------------- | --------------------------------- | ---- | ---- | ------------------------------------------------------------ |
Z
z00797030 已提交
899
| id             | number                            | 是   | 否   | 日程id。当调用[addEvent()](#addevent)[addEvents()](#addevents)创建日程时,不填写此参数。 |
Z
z00797030 已提交
900
| type           | [EventType](#eventtype)           | 否   | 是   | 日程类型。                                                   |
Z
z00797030 已提交
901
| title          | string                            | 否   | 否   | 日程标题。不填时,默认为空字符串。                             |
Z
z00797030 已提交
902 903 904
| location       | [Location](#location)             | 否   | 否   | 日程地点。不填时,默认为null。                               |
| startTime      | number                            | 否   | 是   | 日程开始时间。                                               |
| endTime        | number                            | 否   | 是   | 日程结束时间。                                               |
Z
z00797030 已提交
905
| isAllDay       | boolean                           | 否   | 否   | 是否为全天日程。当取值为true时,说明为全天日程;当取值为false时,说明不是全天日程,默认为非全天日程。 |
Z
z00797030 已提交
906
| attendee       | [Attendee](#attendee)[]           | 否   | 否   | 日程参与者。不填时,默认为null。                             |
Z
z00797030 已提交
907 908 909 910 911
| timeZone       | string                            | 否   | 否   | 日程时区。不填时,默认为当前所在时区,当需要创建与当前不一样的时区时,可填入对应的时区。可通过[getTimeZone()](js-apis-system-date-time.md#systemdatetimegettimezone)获取当前系统时区。 |
| reminderTime   | number[]                          | 否   | 否   | 日程提醒时间。不填时,默认为不提醒。                           |
| recurrenceRule | [RecurrenceRule](#recurrencerule) | 否   | 否   | 日程重复规则。不填时,默认为不重复。                           |
| description    | string                            | 否   | 否   | 日程描述。不填时,默认为空字符串。                             |
| service        | [EventService](#eventservice)     | 否   | 否   | 日程服务。不填时,默认没有一键服务。                           |
Z
z00797030 已提交
912 913 914

## CalendarType

Z
z00797030 已提交
915
帐户类型枚举。
Z
z00797030 已提交
916 917 918

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
919 920 921 922 923 924 925
| 名称       | 值           | 说明                 |
| ---------- | ------------ | -------------------- |
| LOCAL      | 'local'      | 本地帐户。           |
| EMAIL      | 'email'      | 邮箱帐户。           |
| BIRTHDAY   | 'birthday'   | 生日帐户。           |
| CALDAV     | 'caldav'     | 支持CalDAV协议帐户。 |
| SUBSCRIBED | 'subscribed' | 订阅帐户。           |
Z
z00797030 已提交
926 927 928 929 930 931 932

## Location

日程地点。

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
933 934
| 名称      | 类型   | 只读 | 必填 | 说明                     |
| --------- | ------ | ---- | ---- | ------------------------ |
Z
z00797030 已提交
935
| location  | string | 否   | 否   | 地点位置。默认为空字符串。 |
Z
z00797030 已提交
936 937
| longitude | number | 否   | 否   | 地点经度。默认为0。        |
| latitude  | number | 否   | 否   | 地点纬度。默认为0。        |
Z
z00797030 已提交
938 939 940

## EventFilter

Z
z00797030 已提交
941
日程过滤器,查询日程时进行筛选过滤,获取符合条件的日程。
Z
z00797030 已提交
942

Z
z00797030 已提交
943
通过[filterById()](#filterbyid)[filterByTime()](#filterbytime)[filterByTitle()](#filterbytitle)任一方法获取日程过滤器,传入[getEvents()](#getevents)过滤。
Z
z00797030 已提交
944

Z
z00797030 已提交
945 946
### filterById

Z
z00797030 已提交
947
static filterById(ids: number[]): EventFilter
Z
z00797030 已提交
948

Z
z00797030 已提交
949
根据日程id过滤日程。
Z
z00797030 已提交
950 951 952 953 954 955 956 957 958 959 960

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

| 参数名 | 类型     | 必填 | 说明         |
| ------ | -------- | ---- | ------------ |
| ids    | number[] | 是   | 日程id数组。 |

**返回值**

Z
z00797030 已提交
961 962 963
| 类型                        | 说明                 |
| --------------------------- | -------------------- |
| [EventFilter](#eventfilter) | 返回日程过滤器对象。 |
Z
z00797030 已提交
964 965 966

**示例**

Z
z00797030 已提交
967
```js
Z
z00797030 已提交
968 969
const filter = calendarManager.EventFilter.filterById([1, 2]);
calendar.getEvents(filter).then((data) => {
Z
z00797030 已提交
970
  console.info("Succeeded in filtering by id");
Z
z00797030 已提交
971
}).catch((err) => {
Z
z00797030 已提交
972
  console.error("Failed to filter by id");
Z
z00797030 已提交
973 974 975 976 977
});
```

### filterByTime

Z
z00797030 已提交
978
static filterByTime(start: number, end: number): EventFilter
Z
z00797030 已提交
979

Z
z00797030 已提交
980
根据日程时间过滤日程。
Z
z00797030 已提交
981 982 983 984 985 986 987 988 989 990 991 992

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

| 参数名 | 类型   | 必填 | 说明       |
| ------ | ------ | ---- | ---------- |
| start  | number | 是   | 开始时间。 |
| end    | number | 是   | 结束时间。 |

**返回值**

Z
z00797030 已提交
993 994 995
| 类型                        | 说明                 |
| --------------------------- | -------------------- |
| [EventFilter](#eventfilter) | 返回日程过滤器对象。 |
Z
z00797030 已提交
996 997 998

**示例**

Z
z00797030 已提交
999
```js
Z
z00797030 已提交
1000 1001
const filter = calendarManager.EventFilter.filterByTime(1686931200000, 1687017600000);
calendar.getEvents(filter).then((data) => {
Z
z00797030 已提交
1002
  console.info("Succeeded in filtering by time");
Z
z00797030 已提交
1003
}).catch((err) => {
Z
z00797030 已提交
1004
  console.error("Failed to filter by time");
Z
z00797030 已提交
1005 1006 1007 1008 1009
});
```

### filterByTitle

Z
z00797030 已提交
1010
static filterByTitle(title: string): EventFilter
Z
z00797030 已提交
1011

Z
z00797030 已提交
1012
根据日程标题过滤日程。
Z
z00797030 已提交
1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023

**系统能力**: SystemCapability.Applications.CalendarData

**参数**

| 参数名 | 类型   | 必填 | 说明       |
| ------ | ------ | ---- | ---------- |
| title  | string | 是   | 日程标题。 |

**返回值**

Z
z00797030 已提交
1024 1025 1026
| 类型                        | 说明                 |
| --------------------------- | -------------------- |
| [EventFilter](#eventfilter) | 返回日程过滤器对象。 |
Z
z00797030 已提交
1027 1028 1029

**示例**

Z
z00797030 已提交
1030
```js
Z
z00797030 已提交
1031
const filter = calendarManager.EventFilter.filterByTitle('MyEvent');
Z
z00797030 已提交
1032 1033
calendar.getEvents(filter).then((data) => {
  console.info("Succeeded in filtering by title");
Z
z00797030 已提交
1034
}).catch((err) => {
Z
z00797030 已提交
1035
  console.error("Failed to filter by title");
Z
z00797030 已提交
1036 1037 1038 1039 1040
});
```

## EventType

Z
z00797030 已提交
1041
日程类型枚举。
Z
z00797030 已提交
1042 1043 1044

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
1045 1046 1047
| 名称      | 值   | 说明                 |
| --------- | ---- | -------------------- |
| NORMAL    | 0    | 普通日程。           |
Z
z00797030 已提交
1048
| IMPORTANT | 1    | 重要日程。支持倒计时。 |
Z
z00797030 已提交
1049 1050 1051 1052 1053 1054 1055

## RecurrenceRule

日程重复规则。

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
1056 1057 1058
| 名称                | 类型                                        | 只读 | 必填 | 说明                            |
| ------------------- | ------------------------------------------- | ---- | ---- | ------------------------------- |
| recurrenceFrequency | [RecurrenceFrequency](#recurrencefrequency) | 否   | 是   | 日程重复规则类型。              |
Z
z00797030 已提交
1059
| expire              | number                                      | 否   | 否   | 重复周期截止日。不填时,默认为0。 |
Z
z00797030 已提交
1060 1061 1062

## RecurrenceFrequency

Z
z00797030 已提交
1063
日程重复规则类型枚举。
Z
z00797030 已提交
1064 1065 1066

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
1067 1068 1069 1070 1071 1072
| 名称    | 值   | 说明       |
| ------- | ---- | ---------- |
| YEARLY  | 0    | 每年重复。 |
| MONTHLY | 1    | 每月重复。 |
| WEEKLY  | 2    | 每周重复。 |
| DAILY   | 3    | 每天重复。 |
Z
z00797030 已提交
1073 1074 1075 1076 1077 1078 1079

## Attendee

日程参与者。

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
1080 1081 1082 1083
| 名称  | 类型   | 只读 | 必填 | 说明           |
| ----- | ------ | ---- | ---- | -------------- |
| name  | string | 否   | 是   | 参与者的姓名。 |
| email | string | 否   | 是   | 参与者的邮箱。 |
Z
z00797030 已提交
1084 1085 1086 1087 1088 1089 1090

## EventService

日程服务。

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
1091 1092 1093
| 名称        | 类型                        | 只读 | 必填 | 说明                                  |
| ----------- | --------------------------- | ---- | ---- | ------------------------------------- |
| type        | [ServiceType](#servicetype) | 否   | 是   | 服务类型。                            |
Z
z00797030 已提交
1094 1095
| uri         | string                      | 否   | 是   | 服务的uri。可以跳转到三方应用相应界面。 |
| description | string                      | 否   | 否   | 服务辅助描述。不填时,默认为空字符串。  |
Z
z00797030 已提交
1096 1097 1098

## ServiceType

Z
z00797030 已提交
1099
日程服务类型枚举。
Z
z00797030 已提交
1100 1101 1102

**系统能力**:SystemCapability.Applications.CalendarData

Z
z00797030 已提交
1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113
| 名称            | 值               | 说明         |
| --------------- | ---------------- | ------------ |
| MEETING         | 'Meeting'        | 一键入会。   |
| WATCHING        | 'Watching'       | 一键追剧。   |
| REPAYMENT       | 'Repayment'      | 一键还款。   |
| LIVE            | 'Live'           | 一键直播。   |
| SHOPPING        | 'Shopping'       | 一键购物。   |
| TRIP            | 'Trip'           | 一键查看。   |
| CLASS           | 'Class'          | 一键上课。   |
| SPORTS_EVENTS   | 'SportsEvents'   | 一键看赛事。 |
| SPORTS_EXERCISE | 'SportsExercise' | 一键运动。   |