1# Introduction to Calendar Kit
2
3Calendar Kit provides calendar and event management capabilities, which usually refer to APIs that can be used to access and operate calendar data. These APIs allow you to integrate time-related event services (such as travel, catering, sports, and entertainment) in other applications with the system calendar to implement functions such as event management, creation, and query.
4
5## Available Capabilities
6
7Calendar Kit provides management capability for accounts and events.
8
9- Create a calendar account.
10
11  You can create a calendar account specific to your application, after which an account ID is returned. The account ID is the auto-increment primary key of the data table and is used as the unique identifier of the account.
12
13- Obtain the calendar account.
14
15  You can obtain information about a specified calendar account or all calendar accounts created by the current application.
16
17- Delete a calendar account.
18
19  You can delete a specified calendar account, after which all events associated with the calendar account will be deleted.
20
21- Create a calendar event.
22
23  After obtaining the calendar account information, you can create an event under the obtained calendar account. When creating an event, you can set an event reminder and its notification is displayed when the set time arrives.
24
25  After a calendar account is created, an account ID is returned. The account ID is the auto-increment primary key of the data table and is used as the unique identifier of the account.
26
27- Delete an event.
28
29  You can delete one or more events with specified event IDs at a time.
30
31- Update an event.
32
33  You can update event information based on the event ID, including the event title, location, start time, end time, and reminder time.
34
35- Query events.
36
37  You can query events by event ID, event title, event start time, and event end time.
38
39## Features
40
41**One-click event service**: With the permanent authorization mechanism, after the user allows your application to read and write the system calendar, the corresponding event service can be written into the calendar in the form of deeplink. According to the reminder rules set by yourself, when an event is about to expire or expires, the corresponding service button will be displayed in the calendar application, notification, and widgets. Users can tap the button to redirect to the service landing page in one step.
42
43## Working Principles
44
45Calendar Kit provides a set of APIs for obtaining calendar accounts, and writing calendar events to or reading events from the obtained accounts. If an event has a reminder time set, the system sends a reminder to the user when the set time arrives.
46
47## Constraints
48
49- To use the capabilities of Calendar Kit, you need to obtain the **ohos.permission.READ_CALENDAR** and **ohos.permission.WRITE_CALENDAR** permissions to read or write calendars and events. For details, see [Declaring Permissions](../security/AccessToken/declare-permissions.md).
50
51- Currently, the capabilities and APIs of Calendar Kit can be used only in the stage model.
52