
【HarmonyOS Next】Calendar Kit日历管理 原创
简介
Calendar Kit提供日历与日程管理能力,包括日历的获取和日程的创建能力。
Calendar Kit为用户提供了一系列接口来获取日历账户,并使用特定的接口向日历账户中写入日程。
如果写入的日程带有提醒时间则系统会在时间到达时向用户发送提醒。
约束点
-
需要用户手动授权获取读取、写入日历日程的权限。
-
仅支持stage模型。
-
从api11开始支持
相关知识
配置需要的权限
在module.json5中配置所需申请的权限
在EntryAbility中配置权限和日历管理器
EntryAbility中检查用户是否确认权限:
日历管理器(CalendarManager)
提供了添加、删除、获取日历账户的相关方法。如果不需要关注日程(Event)的账户(Calendar)归属时,可以直接使用getCalendar方法直接获取。
相关方法如下:
-
createCalendar(calendarAccount: CalendarAccount, callback: AsyncCallback<Calendar>): void
-
createCalendar(calendarAccount: CalendarAccount): Promise<Calendar>
-
deleteCalendar(calendar: Calendar, callback: AsyncCallback<void>): void
-
deleteCalendar(calendar: Calendar): Promise<void>
-
getCalendar(callback: AsyncCallback<Calendar>): void
-
getCalendar(calendarAccount: CalendarAccount, callback: AsyncCallback<Calendar>): void
-
getCalendar(calendarAccount?: CalendarAccount): Promise<Calendar>
-
getAllCalendars(callback: AsyncCallback<Calendar[]>): void
-
getAllCalendars(): Promise<Calendar[]>
日历账户(Calendar)
可以对账户中的日程进行创建、删除、修改、查询等操作,还有日历配置信息、日历账户信息等方法
日程(Event)
