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

Z
z00797030 已提交
3
本模块提供帐户与日程管理能力,包括创建、删除、修改、查询等。
Z
z00797030 已提交
4 5 6 7 8 9 10 11 12

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


## 导入模块

```javascript
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
根据传入的信息,创建一个帐户,使用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 32
| calendarAccount | [CalendarAccount](#calendaraccount)   | 是   | 帐户信息实例。                     |
| callback        | AsyncCallback\<[Calendar](#calendar)> | 是   | 回调函数,返回创建的Calendar对象。 |
Z
z00797030 已提交
33 34 35

**示例**

Z
z00797030 已提交
36 37
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
38 39 40 41 42 43 44 45 46 47 48 49

calendarManager.createCalendar({ name: 'MyCalendar', type: calendarManager.CalendarType.LOCAL }, (err, data) => {
  if (err) {
    console.log("create calendar failed");
  } else {
    console.log("create calendar success");
  }
});
```

## calendarManager.createCalendar

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

Z
z00797030 已提交
52
根据传入的信息,创建一个帐户,使用Promise异步回调。
Z
z00797030 已提交
53 54 55 56 57 58 59 60 61

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

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

**参数**

| 参数名          | 类型                                | 必填 | 说明           |
| --------------- | ----------------------------------- | ---- | -------------- |
Z
z00797030 已提交
62
| calendarAccount | [CalendarAccount](#calendaraccount) | 是   | 帐户信息实例。 |
Z
z00797030 已提交
63 64 65

**返回值**

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

**示例**

Z
z00797030 已提交
72 73
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
74 75 76 77 78 79 80 81 82 83

calendarManager.createCalendar({ name: 'MyCalendar', type: calendarManager.CalendarType.LOCAL }).then((data) => {
  console.log("create calendar success");
}).catch((err) => {
  console.log("create calendar failed");
});
```

## calendarManager.deleteCalendar

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

Z
z00797030 已提交
86
删除指定帐户,使用callback异步回调。
Z
z00797030 已提交
87 88 89 90 91 92 93 94 95

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

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

**参数**

| 参数名   | 类型                  | 必填 | 说明       |
| -------- | --------------------- | ---- | ---------- |
Z
z00797030 已提交
96 97
| calendar | [Calendar](#calendar) | 是   | 帐户实例。 |
| callback | AsyncCallback\<void>  | 是   | 回调函数。 |
Z
z00797030 已提交
98 99 100

**示例**

Z
z00797030 已提交
101 102
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
103 104 105 106 107 108 109 110 111 112 113 114 115

const calendar = await calendarManager.getCalendar({ name: 'MyCalendar', type: calendarManager.CalendarType.LOCAL });
calendarManager.deleteCalendar(calendar, (err, data) => {
  if (err) {
    console.log("delete calendar failed");
  } else {
    console.log("delete calendar success");
  }
});
```

## calendarManager.deleteCalendar

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

Z
z00797030 已提交
118
删除指定帐户,使用Promise异步回调。
Z
z00797030 已提交
119 120 121 122 123 124 125 126 127

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

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

**参数**

| 参数名   | 类型                  | 必填 | 说明       |
| -------- | --------------------- | ---- | ---------- |
Z
z00797030 已提交
128
| calendar | [Calendar](#calendar) | 是   | 帐户实例。 |
Z
z00797030 已提交
129 130 131

**返回值**

Z
z00797030 已提交
132 133 134
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
135 136 137

**示例**

Z
z00797030 已提交
138 139
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
140 141 142 143 144 145 146 147 148 149 150

const calendar = await calendarManager.getCalendar({ name: 'MyCalendar', type: calendarManager.CalendarType.LOCAL });
calendarManager.deleteCalendar(calendar).then((data) => {
  console.log("delete calendar success");
}).catch((err) => {
  console.log("delete calendar failed");
});
```

## calendarManager.getCalendar

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

Z
z00797030 已提交
153
获取默认帐户,使用callback异步回调。
Z
z00797030 已提交
154 155 156 157 158 159 160

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

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

**参数**

Z
z00797030 已提交
161 162 163
| 参数名   | 类型                                 | 必填 | 说明                               |
| -------- | ------------------------------------ | ---- | ---------------------------------- |
| callback | AsyncCallback<[Calendar](#calendar)> | 是   | 回调函数,返回查询的Calendar对象。 |
Z
z00797030 已提交
164 165 166

**示例**

Z
z00797030 已提交
167 168
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
169 170 171 172 173 174 175 176 177 178 179 180

calendarManager.getCalendar((err, data) => {
  if (err) {
    console.log("get calendar failed");
  } else {
    console.log("get calendar success");
  }
});
```

## calendarManager.getCalendar

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

Z
z00797030 已提交
183
获取指定帐户,使用callback异步回调。
Z
z00797030 已提交
184 185 186 187 188 189 190

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

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

**参数**

Z
z00797030 已提交
191 192 193 194
| 参数名          | 类型                                 | 必填 | 说明                               |
| --------------- | ------------------------------------ | ---- | ---------------------------------- |
| calendarAccount | [CalendarAccount](#calendaraccount)  | 是   | 帐户信息实例。                     |
| callback        | AsyncCallback<[Calendar](#calendar)> | 是   | 回调函数,返回查询的Calendar对象。 |
Z
z00797030 已提交
195 196 197

**示例**

Z
z00797030 已提交
198 199
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
200 201 202 203 204 205 206 207 208 209 210 211

calendarManager.getCalendar({ name: 'MyCalendar', type: calendarManager.CalendarType.LOCAL }, (err, data) => {
  if (err) {
    console.log("get calendar failed");
  } else {
    console.log("get calendar success");
  }
});
```

## calendarManager.getCalendar

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

Z
z00797030 已提交
214
获取帐户,不传参数时获取默认帐户,传参时获取指定帐户,使用Promise异步回调。
Z
z00797030 已提交
215 216 217 218 219 220 221

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

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

**参数**

Z
z00797030 已提交
222 223 224
| 参数名          | 类型                                | 必填 | 说明           |
| --------------- | ----------------------------------- | ---- | -------------- |
| calendarAccount | [CalendarAccount](#calendaraccount) | 否   | 帐户信息实例。 |
Z
z00797030 已提交
225 226 227

**返回值**

Z
z00797030 已提交
228 229 230
| 类型                           | 说明                                  |
| ------------------------------ | ------------------------------------- |
| Promise<[Calendar](#calendar)> | Promise对象,返回查询的Calendar对象。 |
Z
z00797030 已提交
231 232 233

**示例**

Z
z00797030 已提交
234 235
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
236 237 238 239 240 241 242 243 244 245 246


calendarManager.getCalendar().then((data) => {
  console.log("get calendar success");
}).catch((err) => {
  console.log("get calendar failed");
});
```

## calendarManager.getAllCalendars

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

Z
z00797030 已提交
249
获取当前应用所有创建的帐户以及默认帐户,使用callback异步回调。
Z
z00797030 已提交
250

Z
z00797030 已提交
251
**需要权限**:ohos.permission.READ_CALENDAR or ohos.permission.READ_WHOLE_CALENDAR
Z
z00797030 已提交
252 253 254 255 256

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

**参数**

Z
z00797030 已提交
257 258 259
| 参数名   | 类型                                   | 必填 | 说明                                    |
| -------- | -------------------------------------- | ---- | --------------------------------------- |
| callback | AsyncCallback<[Calendar](#calendar)[]> | 是   | 回调函数, 返回查询的Calendar帐户数组。 |
Z
z00797030 已提交
260 261 262

**示例**

Z
z00797030 已提交
263 264
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
265 266 267 268 269 270 271 272 273 274 275 276

calendarManager.getAllCalendars((err, data) => {
  if (err) {
    console.log("get all calendars failed");
  } else {
    console.log("get all calendars success");
  }
});
```

## calendarManager.getAllCalendars

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

Z
z00797030 已提交
279
获取当前应用所有创建的帐户以及默认帐户,使用Promise异步回调。
Z
z00797030 已提交
280

Z
z00797030 已提交
281
**需要权限**: ohos.permission.READ_CALENDAR or ohos.permission.WRITE_WHOLE_CALENDAR
Z
z00797030 已提交
282 283 284 285 286

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

**返回值**

Z
z00797030 已提交
287 288 289
| 类型                             | 说明                                      |
| -------------------------------- | ----------------------------------------- |
| Promise<[Calendar](#calendar)[]> | Promise对象,返回查询的Calendar帐户数组。 |
Z
z00797030 已提交
290 291 292

**示例**

Z
z00797030 已提交
293 294
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
295 296 297 298 299 300 301 302 303 304

calendarManager.getAllCalendars().then((data) => {
  console.log("get all calendars success");
}).catch((err) => {
  console.log("get all calendars failed");
});
```

## Calendar

Z
z00797030 已提交
305 306 307 308
帐户实例。描述Calendar对象的属性和方法。

下列API示例中需先通过[createCalendar()](#calendarManager.createCalendar)[getCalendar()](#calendarManager.getCalendar)中任一方法获取Calendar实例,再通过此实例调用对应方法。

Z
z00797030 已提交
309 310 311 312
### 属性

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

Z
z00797030 已提交
313 314 315
| 名称 | 类型   | 只读 | 必填 | 说明     |
| ---- | ------ | ---- | ---- | -------- |
| id   | number | 是   | 是   | 帐户id。 |
Z
z00797030 已提交
316 317 318

### addEvent

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

Z
z00797030 已提交
321
根据传入的信息,创建一个日程,使用callback异步回调。
Z
z00797030 已提交
322 323 324 325 326

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

**参数**

Z
z00797030 已提交
327 328 329 330
| 参数名   | 类型                   | 必填 | 说明                   |
| -------- | ---------------------- | ---- | ---------------------- |
| event    | [Event](#event)        | 是   | 日程具体参数实例。     |
| callback | AsyncCallback\<number> | 是   | 回调函数,返回日程id。 |
Z
z00797030 已提交
331 332 333

**示例**

Z
z00797030 已提交
334 335
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
336 337 338 339 340

const calendar = await calendarManager.getCalendar();
const date = new Date();
const event: calendarManager.Event = {
  type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
341 342
  startTime: date.getTime(),
  endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
343 344 345 346 347 348 349 350 351 352 353 354
};
calendar.addEvent(event, (err, data) => {
  if (err) {
    console.log("add event failed");
  } else {
    console.log("add event success");
  }
});
```

### addEvent

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

Z
z00797030 已提交
357
根据传入的信息,创建一个日程,使用Promise异步回调。
Z
z00797030 已提交
358 359 360 361 362 363 364

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

**参数**

| 参数名 | 类型            | 必填 | 说明               |
| ------ | --------------- | ---- | ------------------ |
Z
z00797030 已提交
365
| event  | [Event](#event) | 是   | 日程具体参数实例。 |
Z
z00797030 已提交
366 367 368

**返回值**

Z
z00797030 已提交
369 370 371
| 类型             | 说明                        |
| ---------------- | --------------------------- |
| Promise\<number> | Promise对象,返回日程的id。 |
Z
z00797030 已提交
372 373 374

**示例**

Z
z00797030 已提交
375 376
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
377 378 379 380 381

const calendar = await calendarManager.getCalendar();
const date = new Date();
const event: calendarManager.Event = {
  type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
382 383
  startTime: date.getTime(),
  endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
384 385 386 387 388 389 390 391 392 393
};
calendar.addEvent(event).then((data) => {
  console.log("add event success");
}).catch((err) => {
  console.log("add event failed");
});
```

### addEvents

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

Z
z00797030 已提交
396
根据传入的信息,批量创建日程,使用callback异步回调。
Z
z00797030 已提交
397 398 399 400 401

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

**参数**

Z
z00797030 已提交
402 403 404 405
| 参数名   | 类型                 | 必填 | 说明                   |
| -------- | -------------------- | ---- | ---------------------- |
| events   | [Event](#event)[]    | 是   | 日程具体参数实例数组。 |
| callback | AsyncCallback\<void> | 是   | 回调函数。             |
Z
z00797030 已提交
406 407 408

**示例**

Z
z00797030 已提交
409 410
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
411 412 413 414 415 416

const calendar = await calendarManager.getCalendar();
const date = new Date();
const events: calendarManager.Event[] = [
  {
    type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
417 418
    startTime: date.getTime(),
    endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
419 420 421
  },
  {
    type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
422 423
    startTime: date.getTime(),
    endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
424 425 426 427 428 429 430 431 432 433 434 435 436
  }
];
calendar.addEvents(events, (err, data) => {
  if (err) {
    console.log("add events failed");
  } else {
    console.log("add events success");
  }
});
```

### addEvents

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

Z
z00797030 已提交
439
根据传入的信息,批量创建日程,使用Promise异步回调。
Z
z00797030 已提交
440 441 442 443 444 445 446

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

**参数**

| 参数名 | 类型              | 必填 | 说明                   |
| ------ | ----------------- | ---- | ---------------------- |
Z
z00797030 已提交
447
| events | [Event](#event)[] | 是   | 日程具体参数实例数组。 |
Z
z00797030 已提交
448 449 450

**返回值**

Z
z00797030 已提交
451 452 453
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
454 455 456

**示例**

Z
z00797030 已提交
457 458
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
459 460 461 462 463 464

const calendar = await calendarManager.getCalendar();
const date = new Date();
const events: calendarManager.Event[] = [
  {
    type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
465 466
    startTime: date.getTime(),
    endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
467 468 469
  },
  {
    type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
470 471
    startTime: date.getTime(),
    endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
472 473 474 475 476 477 478 479 480 481 482
  }
];
calendar.addEvents(events).then(() => {
  console.log("add events success");
}).catch((err) => {
  console.log("add events failed");
});
```

### deleteEvent

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

Z
z00797030 已提交
485
删除指定id的日程,使用callback异步回调。
Z
z00797030 已提交
486 487 488 489 490

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

**参数**

Z
z00797030 已提交
491 492 493 494
| 参数名   | 类型                 | 必填 | 说明       |
| -------- | -------------------- | ---- | ---------- |
| id       | number               | 是   | 日程id。   |
| callback | AsyncCallback\<void> | 是   | 回调函数。 |
Z
z00797030 已提交
495 496 497

**示例**

Z
z00797030 已提交
498 499
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
500 501 502 503 504 505 506 507 508 509 510 511 512

const calendar = await calendarManager.getCalendar();
calendar.deleteEvent(1, (err, data) => {
  if (err) {
    console.log("delete event failed");
  } else {
    console.log("delete event success");
  }
});
```

### deleteEvent

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

Z
z00797030 已提交
515
删除指定id的日程,使用Promise异步回调。
Z
z00797030 已提交
516 517 518 519 520 521 522 523 524 525 526

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

**参数**

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

**返回值**

Z
z00797030 已提交
527 528 529
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
530 531 532

**示例**

Z
z00797030 已提交
533 534
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
535 536 537 538 539 540 541 542 543 544 545

const calendar = await calendarManager.getCalendar();
calendar.deleteEvent(1).then(() => {
  console.log("delete event success");
}).catch((err) => {
  console.log("delete event failed");
});
```

### deleteEvents

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

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

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

**参数**

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

**示例**

Z
z00797030 已提交
561 562
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
563 564 565 566 567 568 569 570 571 572 573 574 575

const calendar = await calendarManager.getCalendar();
calendar.deleteEvents([1, 2], (err, data) => {
  if (err) {
    console.log("delete events failed");
  } else {
    console.log("delete events success");
  }
});
```

### deleteEvents

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

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

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

**参数**

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

**返回值**

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

**示例**

Z
z00797030 已提交
596 597
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
598 599 600 601 602 603 604 605 606 607 608

const calendar = await calendarManager.getCalendar();
calendar.deleteEvents([1, 2]).then(() => {
  console.log("delete events success");
}).catch((err) => {
  console.log("delete events failed");
});
```

### updateEvent

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

Z
z00797030 已提交
611
根据日程实例对象,更新日程,使用callback异步回调。
Z
z00797030 已提交
612 613 614 615 616

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

**参数**

Z
z00797030 已提交
617 618 619 620
| 参数名   | 类型                 | 必填 | 说明               |
| -------- | -------------------- | ---- | ------------------ |
| event    | [Event](#event)      | 是   | 日程具体参数示例。 |
| callback | AsyncCallback\<void> | 是   | 回调函数。         |
Z
z00797030 已提交
621 622 623

**示例**

Z
z00797030 已提交
624 625
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
626 627 628 629 630 631 632

const calendar = await calendarManager.getCalendar();
const date = new Date();
const event: calendarManager.Event = {
  id: 1,
  title: 'update',
  type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
633 634
  startTime: date.getTime(),
  endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
635 636 637 638 639 640 641 642 643 644 645 646
};
calendar.updateEvent(event, (err, data) => {
  if (err) {
    console.log("update event failed");
  } else {
    console.log("update event success");
  }
});
```

### updateEvent

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

Z
z00797030 已提交
649
根据日程实例对象,更新日程,使用Promise异步回调。
Z
z00797030 已提交
650 651 652 653 654 655 656

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

**参数**

| 参数名 | 类型            | 必填 | 说明               |
| ------ | --------------- | ---- | ------------------ |
Z
z00797030 已提交
657
| event  | [Event](#event) | 是   | 日程具体参数示例。 |
Z
z00797030 已提交
658 659 660

**返回值**

Z
z00797030 已提交
661 662 663
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
664 665 666

**示例**

Z
z00797030 已提交
667 668
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
669 670 671 672 673 674 675

const calendar = await calendarManager.getCalendar();
const date = new Date();
const event: calendarManager.Event = {
  id: 1,
  title: 'update',
  type: calendarManager.EventType.NORMAL,
Z
z00797030 已提交
676 677
  startTime: date.getTime(),
  endTime: date.getTime() + 60 * 60 * 1000
Z
z00797030 已提交
678 679 680 681 682 683 684 685 686 687
};
calendar.updateEvent(event).then(() => {
  console.log("update event success");
}).catch((err) => {
  console.log("update event failed");
});
```

### getEvents

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

Z
z00797030 已提交
690
查询帐户下所有日程,使用callback异步回调。
Z
z00797030 已提交
691 692 693 694 695 696 697

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

**参数**

| 参数名   | 类型                             | 必填 | 说明                             |
| -------- | -------------------------------- | ---- | -------------------------------- |
Z
z00797030 已提交
698
| callback | AsyncCallback<[Event](#event)[]> | 是   | 回调函数,返回的是日程实例数组。 |
Z
z00797030 已提交
699 700 701

**示例**

Z
z00797030 已提交
702 703
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
704 705 706 707 708 709 710 711 712 713 714 715 716

const calendar = await calendarManager.getCalendar();
calendar.getEvents((err, data) => {
  if (err) {
    console.log("get events failed");
  } else {
    console.log("get events success");
  }
});
```

### getEvents

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

Z
z00797030 已提交
719
获取帐户下符合查询条件的日程,使用callback异步回调。
Z
z00797030 已提交
720 721 722 723 724 725 726

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

**参数**

| 参数名      | 类型                             | 必填 | 说明                             |
| ----------- | -------------------------------- | ---- | -------------------------------- |
Z
z00797030 已提交
727 728 729
| eventFilter | [EventFilter](#eventfilter)      | 是   | 查询条件。                       |
| eventKey    | (keyof [Event](#event))[]        | 是   | 查询结果集。                     |
| callback    | AsyncCallback<[Event](#event)[]> | 是   | 回调函数,返回的是日程实例数组。 |
Z
z00797030 已提交
730 731 732

**示例**

Z
z00797030 已提交
733 734
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
735 736 737

const calendar = await calendarManager.getCalendar();
const filter = calendarManager.EventFilter.filterById([1, 2]);
Z
z00797030 已提交
738
const columns: (keyof calendarManager.Event)[] =  ['title', 'type', 'startTime', 'endTime'];
Z
z00797030 已提交
739 740 741 742 743 744 745 746 747 748 749
calendar.getEvents(filter, columns, (err, data) => {
  if (err) {
    console.log("get events failed");
  } else {
    console.log("get events success");
  }
});
```

### getEvents

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

Z
z00797030 已提交
752
获取帐户下符合查询条件的日程,使用Promise异步回调。
Z
z00797030 已提交
753 754 755 756 757

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

**参数**

Z
z00797030 已提交
758 759 760 761
| 参数名      | 类型                        | 必填 | 说明         |
| ----------- | --------------------------- | ---- | ------------ |
| eventFilter | [EventFilter](#eventfilter) | 否   | 查询条件。   |
| eventKey    | (keyof [Event](#event))[]   | 否   | 查询结果集。 |
Z
z00797030 已提交
762 763 764

**返回值**

Z
z00797030 已提交
765 766 767
| 类型                       | 说明                            |
| -------------------------- | ------------------------------- |
| Promise<[Event](#event)[]> | Promise对象,返回日程实例数组。 |
Z
z00797030 已提交
768 769 770

**示例**

Z
z00797030 已提交
771 772
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
773 774 775 776 777 778 779 780 781 782 783 784

const calendar = await calendarManager.getCalendar();
const filter = calendarManager.EventFilter.filterByTitle('MyEvent');
calendar.getEvents(filter).then((data) => {
  console.log("get events success");
}).catch((err) => {
  console.log("get events failed");
});
```

### getConfig

Z
z00797030 已提交
785
getConfig(): CalendarConfig
Z
z00797030 已提交
786

Z
z00797030 已提交
787
获取帐户具体参数。
Z
z00797030 已提交
788 789 790 791 792 793 794

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

**返回值**

| 类型                              | 说明               |
| --------------------------------- | ------------------ |
Z
z00797030 已提交
795
| [CalendarConfig](#calendarconfig) | 返回帐户参数实例。 |
Z
z00797030 已提交
796 797 798

**示例**

Z
z00797030 已提交
799 800
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
801 802 803 804 805 806 807 808

const calendar = await calendarManager.getCalendar();
const config = calendar.getConfig();
console.log("get config success");
```

### setConfig

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

Z
z00797030 已提交
811
设置帐户参数,使用callback异步回调。
Z
z00797030 已提交
812 813 814 815 816

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

**参数**

Z
z00797030 已提交
817 818 819 820
| 参数名   | 类型                              | 必填 | 说明               |
| -------- | --------------------------------- | ---- | ------------------ |
| config   | [CalendarConfig](#calendarconfig) | 是   | 帐户具体参数实例。 |
| callback | AsyncCallback\<void>              | 是   | 回调函数。         |
Z
z00797030 已提交
821 822 823

**示例**

Z
z00797030 已提交
824 825
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841

const calendar = await calendarManager.getCalendar();
const config: calendarManager.CalendarConfig = {
  enableReminder: true
};
calendar.setConfig(config, (err, data) => {
  if (err) {
    console.log("set config failed");
  } else {
    console.log("set config success");
  }
});
```

### setConfig

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

Z
z00797030 已提交
844
设置帐户参数,使用Promise异步回调。
Z
z00797030 已提交
845 846 847 848 849

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

**参数**

Z
z00797030 已提交
850 851 852
| 参数名 | 类型                              | 必填 | 说明               |
| ------ | --------------------------------- | ---- | ------------------ |
| config | [CalendarConfig](#calendarconfig) | 是   | 帐户具体参数实例。 |
Z
z00797030 已提交
853 854 855

**返回值**

Z
z00797030 已提交
856 857 858
| 类型           | 说明                      |
| -------------- | ------------------------- |
| Promise\<void> | 无返回结果的Promise对象。 |
Z
z00797030 已提交
859 860 861

**示例**

Z
z00797030 已提交
862 863
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
864 865 866 867 868 869 870 871 872 873 874 875 876 877

const calendar = await calendarManager.getCalendar();
const config: calendarManager.CalendarConfig = {
  enableReminder: true
};
calendar.setConfig(config).then(() => {
  console.log("set config success");
}).catch((err) => {
  console.log("set config failed");
});
```

### getAccount

Z
z00797030 已提交
878
getAccount(): CalendarAccount
Z
z00797030 已提交
879

Z
z00797030 已提交
880
获取帐户信息。
Z
z00797030 已提交
881 882 883 884 885 886 887

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

**返回值**

| 类型                                | 说明               |
| ----------------------------------- | ------------------ |
Z
z00797030 已提交
888
| [CalendarAccount](#calendaraccount) | 返回帐户信息实例。 |
Z
z00797030 已提交
889 890 891

**示例**

Z
z00797030 已提交
892 893
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
894 895 896 897 898 899 900 901

const calendar = await calendarManager.getCalendar();
const account = calendar.getAccount();
console.log("get account success");
```

## CalendarAccount

Z
z00797030 已提交
902
日历帐户。
Z
z00797030 已提交
903 904 905

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

Z
z00797030 已提交
906 907 908 909 910
| 名称        | 类型                          | 只读 | 必填 | 说明             |
| ----------- | ----------------------------- | ---- | ---- | ---------------- |
| name        | string                        | 是   | 是   | 帐户名称。       |
| type        | [CalendarType](#calendartype) | 否   | 是   | 帐户类型。       |
| displayName | string                        | 否   | 否   | 帐户的显示名称。 |
Z
z00797030 已提交
911 912 913

## CalendarConfig

Z
z00797030 已提交
914
帐户参数。
Z
z00797030 已提交
915 916 917

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

Z
z00797030 已提交
918 919 920 921
| 名称           | 类型          | 只读 | 必填 | 说明           |
| -------------- | ------------- | ---- | ---- | -------------- |
| enableReminder | boolean       | 否   | 否   | 帐户提醒能力。 |
| color          | ResourceColor | 否   | 否   | 帐户颜色。     |
Z
z00797030 已提交
922 923 924 925 926

## Event

日程实例对象,用于设置日程标题、开始时间、结束时间等具体信息。

Z
z00797030 已提交
927 928
通过[addEvent()](#addEvent)[addEvents()](#addEvents)中的任一方法创建,通过[getEvents()](#getEvents)方法获取Event实例。

Z
z00797030 已提交
929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945
**系统能力**:SystemCapability.Applications.CalendarData

| 名称           | 类型                              | 只读 | 必填 | 说明             |
| -------------- | --------------------------------- | ---- | ---- | ---------------- |
| id             | number                            | 是   | 否   | 日程id。         |
| type           | [EventType](#eventtype)           | 否   | 是   | 日程类型。       |
| title          | string                            | 否   | 否   | 日程标题。       |
| location       | [Location](#location)             | 否   | 否   | 日程地点。       |
| startTime      | number                            | 否   | 是   | 日程开始时间。   |
| endTime        | number                            | 否   | 是   | 日程结束时间。   |
| isAllDay       | boolean                           | 否   | 否   | 是否为全天日程。 |
| attendee       | [Attendee](#attendee)[]           | 否   | 否   | 日程参与者。     |
| timeZone       | string                            | 否   | 否   | 日程时区。       |
| reminderTime   | number[]                          | 否   | 否   | 日程提醒时间。   |
| recurrenceRule | [RecurrenceRule](#recurrencerule) | 否   | 否   | 日程重复规则。   |
| description    | string                            | 否   | 否   | 日程描述。       |
| service        | [EventService](#eventservice)     | 否   | 否   | 日程服务。       |
Z
z00797030 已提交
946 947 948

## CalendarType

Z
z00797030 已提交
949
帐户类型。
Z
z00797030 已提交
950 951 952

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

Z
z00797030 已提交
953 954 955 956 957 958 959
| 名称       | 值           | 说明         |
| ---------- | ------------ | ------------ |
| LOCAL      | 'local'      | 本地帐户。   |
| EMAIL      | 'email'      | 邮箱帐户。   |
| BIRTHDAY   | 'birthday'   | 生日帐户。   |
| CALDAV     | 'caldav'     | CalDAV帐户。 |
| SUBSCRIBED | 'subscribed' | 订阅帐户。   |
Z
z00797030 已提交
960 961 962 963 964 965 966

## Location

日程地点。

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

Z
z00797030 已提交
967 968 969 970 971
| 名称      | 类型    | 只读 | 必填 | 说明       |
| --------- | ------- | ---- | ---- | ---------- |
| location  | boolean | 否   | 否   | 地点位置。 |
| longitude | number  | 否   | 否   | 地点经度。 |
| latitude  | number  | 否   | 否   | 地点纬度。 |
Z
z00797030 已提交
972 973 974

## EventFilter

Z
z00797030 已提交
975 976 977 978
日程过滤器,查询日程时进行过滤,获取符合条件的日程。

通过[filterById()](#filterById)[filterByTime()](#filterByTime)[filterByTitle()](#filterByTitle)任一方法获取日程过滤器,传入[getEvents()](#getEvents)进行过滤。

Z
z00797030 已提交
979 980
### filterById

Z
z00797030 已提交
981
filterById(ids: number[]): EventFilter
Z
z00797030 已提交
982

Z
z00797030 已提交
983
根据日程id进行过滤日程。
Z
z00797030 已提交
984 985 986 987 988 989 990 991 992 993 994 995 996

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

**参数**

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

**返回值**

| 类型                        | 说明                   |
| --------------------------- | ---------------------- |
Z
z00797030 已提交
997
| [EventFilter](#eventfilter) | 返回日程过滤实例对象。 |
Z
z00797030 已提交
998 999 1000

**示例**

Z
z00797030 已提交
1001 1002
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014

const calendar = await calendarManager.getCalendar();
const filter = calendarManager.EventFilter.filterById([1, 2]);
calendar.getEvents(filter).then((data) => {
  console.log("filter by id success");
}).catch((err) => {
  console.log("filter by id failed");
});
```

### filterByTime

Z
z00797030 已提交
1015
filterByTime(start: number, end: number): EventFilter
Z
z00797030 已提交
1016

Z
z00797030 已提交
1017
根据日程时间进行过滤日程。
Z
z00797030 已提交
1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031

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

**参数**

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

**返回值**

| 类型                        | 说明                   |
| --------------------------- | ---------------------- |
Z
z00797030 已提交
1032
| [EventFilter](#eventfilter) | 返回日程过滤实例对象。 |
Z
z00797030 已提交
1033 1034 1035

**示例**

Z
z00797030 已提交
1036 1037
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049

const calendar = await calendarManager.getCalendar();
const filter = calendarManager.EventFilter.filterByTime(1686931200000, 1687017600000);
calendar.getEvents(filter).then((data) => {
  console.log("filter by time success");
}).catch((err) => {
  console.log("filter by time failed");
});
```

### filterByTitle

Z
z00797030 已提交
1050
filterByTitle(title: string): EventFilter
Z
z00797030 已提交
1051

Z
z00797030 已提交
1052
根据日程时间进行过滤日程。
Z
z00797030 已提交
1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065

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

**参数**

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

**返回值**

| 类型                        | 说明                   |
| --------------------------- | ---------------------- |
Z
z00797030 已提交
1066
| [EventFilter](#eventfilter) | 返回日程过滤实例对象。 |
Z
z00797030 已提交
1067 1068 1069

**示例**

Z
z00797030 已提交
1070 1071
```js
import calendarManager from '@ohos.calendarManager';
Z
z00797030 已提交
1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087

const calendar = await calendarManager.getCalendar();
const filter = calendarManager.EventFilter.filterByTitle('MyEvent');
calendar.getEvents(filter).then(() => {
  console.log("filter by title success");
}).catch((err) => {
  console.log("filter by title failed");
});
```

## EventType

日程类型。

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

Z
z00797030 已提交
1088 1089 1090 1091
| 名称      | 值   | 说明       |
| --------- | ---- | ---------- |
| NORMAL    | 0    | 普通日程。 |
| IMPORTANT | 1    | 重要日程。 |
Z
z00797030 已提交
1092 1093 1094 1095 1096 1097 1098

## RecurrenceRule

日程重复规则。

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

Z
z00797030 已提交
1099 1100 1101 1102
| 名称                | 类型                                        | 只读 | 必填 | 说明               |
| ------------------- | ------------------------------------------- | ---- | ---- | ------------------ |
| recurrenceFrequency | [RecurrenceFrequency](#recurrencefrequency) | 否   | 否   | 日程重复规则类型。 |
| expire              | number                                      | 否   | 否   | 日程过期时间。     |
Z
z00797030 已提交
1103 1104 1105 1106 1107 1108 1109

## RecurrenceFrequency

日程重复规则类型。

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

Z
z00797030 已提交
1110 1111 1112 1113 1114 1115
| 名称    | 值   | 说明       |
| ------- | ---- | ---------- |
| YEARLY  | 0    | 每年重复。 |
| MONTHLY | 1    | 每月重复。 |
| WEEKLY  | 2    | 每周重复。 |
| DAILY   | 3    | 每天重复。 |
Z
z00797030 已提交
1116 1117 1118 1119 1120 1121 1122

## Attendee

日程参与者。

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

Z
z00797030 已提交
1123 1124 1125 1126
| 名称  | 类型   | 只读 | 必填 | 说明           |
| ----- | ------ | ---- | ---- | -------------- |
| name  | string | 否   | 是   | 参与者的姓名。 |
| email | string | 否   | 是   | 参与者的邮箱。 |
Z
z00797030 已提交
1127 1128 1129 1130 1131 1132 1133

## EventService

日程服务。

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

Z
z00797030 已提交
1134 1135 1136 1137 1138
| 名称        | 类型                        | 只读 | 必填 | 说明         |
| ----------- | --------------------------- | ---- | ---- | ------------ |
| type        | [ServiceType](#servicetype) | 否   | 是   | 服务类型。   |
| uri         | string                      | 否   | 是   | 服务的uri。  |
| description | string                      | 否   | 否   | 服务的描述。 |
Z
z00797030 已提交
1139 1140 1141 1142 1143 1144 1145

## ServiceType

日程服务类型。

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

Z
z00797030 已提交
1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156
| 名称            | 值               | 说明         |
| --------------- | ---------------- | ------------ |
| MEETING         | 'Meeting'        | 一键入会。   |
| WATCHING        | 'Watching'       | 一键追剧。   |
| REPAYMENT       | 'Repayment'      | 一键还款。   |
| LIVE            | 'Live'           | 一键直播。   |
| SHOPPING        | 'Shopping'       | 一键购物。   |
| TRIP            | 'Trip'           | 一键查看。   |
| CLASS           | 'Class'          | 一键上课。   |
| SPORTS_EVENTS   | 'SportsEvents'   | 一键看赛事。 |
| SPORTS_EXERCISE | 'SportsExercise' | 一键运动。   |