日历账户管理:日历管理器CalendarManager用于管理日历账户Calendar。日历账户主要包含账户信息CalendarAccount和配置信息CalendarConfig。
日程的重复规则RecurrenceRule:日程重复规则。
日程重复规则类型枚举RecurrenceFrequency:日程重复规则类型枚举。
全量示例代码:
import { calendarManager } from '@kit.CalendarKit';
import { abilityAccessCtrl, bundleManager, common, Permissions } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { PromptAction } from '@kit.ArkUI';
@Entry
@Component
struct CalenderPage {
@State calendarEventId: number[] = [];
private systemCalendarManager: calendarManager.CalendarManager | null = null;
private systemCalendar: calendarManager.Calendar | undefined | null = undefined;
private permissions: Permissions[] = ['ohos.permission.READ_CALENDAR', 'ohos.permission.WRITE_CALENDAR'];
promptAction: PromptAction = this.getUIContext().getPromptAction();
build() {
RelativeContainer() {
Column() {
Button('创建重复日程')
.onClick(() => {
const result = this.initSystemCalendarAccount();
if (!result) {
return;
}
this.createSystemCalendar();
this.showMessage('已创建重复日程,详情请前往日历应用查看。');
});
Button('更新重复日程为非重复')
.onClick(() => {
const result = this.initSystemCalendarAccount();
if (!result) {
return;
}
this.updateSystemCalendar(this.calendarEventId);
this.showMessage('已更新重复日程为非重复,详情请前往日历应用查看。');
})
.margin(10);
}
.width('100%')
.padding(20);
}
.height('100%')
.width('100%');
}
// 初始化日历账户
public initSystemCalendarAccount() {
// 校验/请求日历权限
if (!this.checkCalendarRemindPerm()) {
this.requestSystemCalendarPermission();
}
if (!this.systemCalendarManager) {
this.systemCalendarManager = calendarManager.getCalendarManager(this.getUIContext().getHostContext());
}
if (!this.systemCalendarManager) {
return false;
}
if (!this.systemCalendar) {
// 初始化账户
this.systemCalendarManager?.getCalendar((err: BusinessError, data: calendarManager.Calendar) => {
if (data) {
this.systemCalendar = data;
}
});
}
if (this.systemCalendar) {
return true;
}
return false;
}
// 检查日历提醒权限
public checkCalendarRemindPerm() {
let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let tokenId: number = this.getTokenId();
let grantStatus: abilityAccessCtrl.GrantStatus = -1;
let result: boolean = true;
for (let i = 0; i < this.permissions.length; i++) {
grantStatus = atManager.checkAccessTokenSync(tokenId, this.permissions[i]);
if (grantStatus !== abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
result = false;
}
}
return result;
}
// 获取应用程序的accessTokenId
private getTokenId() {
let tokenId: number = 0;
let bundleInfo: bundleManager.BundleInfo =
bundleManager.getBundleInfoForSelfSync(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION);
let appInfo: bundleManager.ApplicationInfo = bundleInfo.appInfo;
tokenId = appInfo.accessTokenId;
return tokenId;
}
// 请求系统日历权限
public requestSystemCalendarPermission() {
let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let context: Context = this.getUIContext().getHostContext() as common.UIAbilityContext;
atManager.requestPermissionsFromUser(context, this.permissions);
}
// 创建一个系统日历的日程
public createSystemCalendar() {
if (!this.systemCalendar) {
return;
}
const date: Date = new Date();
const title = '重复性日程-创建';
const startTime = date.getTime() + 10 * 60 * 1000;
const endTime = startTime + 30 * 60 * 1000;
const calendarEvent: calendarManager.Event = {
type: calendarManager.EventType.NORMAL,
startTime: startTime,
endTime: endTime,
title: title,
reminderTime: [0],
recurrenceRule: {
recurrenceFrequency: calendarManager.RecurrenceFrequency.DAILY,
interval: 1
}
};
this.systemCalendar.addEvent(calendarEvent, (err: BusinessError, data: number): void => {
if (data) {
this.calendarEventId.push(data);
}
});
}
// 更新一个系统日历的日程
public updateSystemCalendar(ids: number []) {
if (!this.systemCalendar) {
return;
}
if (!ids || ids.length === 0) {
return;
}
ids.forEach((item: number) => {
const date: Date = new Date();
const title = `不重复日程-更新-${item}`;
const startTime = date.getTime() + 10 * 60 * 1000;
const endTime = startTime + 30 * 60 * 1000;
const calendarEvent: calendarManager.Event = {
type: calendarManager.EventType.NORMAL,
id: item,
startTime: startTime,
endTime: endTime,
title: title,
reminderTime: [0],
recurrenceRule: {
recurrenceFrequency: calendarManager.RecurrenceFrequency.DAILY,
count: 1,
expire: endTime
}
};
this.systemCalendar?.updateEvent(calendarEvent, (err: BusinessError) => {
if (!err) {
this.calendarEventId = this.calendarEventId.filter((num) => num !== item);
}
});
});
}
private showMessage(message: string) {
this.promptAction.openToast({
message: message,
duration: 10000,
}).catch((error: BusinessError) => {
console.error(`openToast error code is ${error.code}, message is ${error.message}`);
});
}
}
创建重复日程示例代码:
// 创建一个系统日历的日程
public createSystemCalendar() {
if (!this.systemCalendar) {
return;
}
const date: Date = new Date();
const title = '重复性日程-创建';
const startTime = date.getTime() + 10 * 60 * 1000;
const endTime = startTime + 30 * 60 * 1000;
const calendarEvent: calendarManager.Event = {
type: calendarManager.EventType.NORMAL,
startTime: startTime,
endTime: endTime,
title: title,
reminderTime: [0],
recurrenceRule: {
recurrenceFrequency: calendarManager.RecurrenceFrequency.DAILY,
interval: 1
}
};
this.systemCalendar.addEvent(calendarEvent, (err: BusinessError, data: number): void => {
if (data) {
this.calendarEventId.push(data);
}
});
}
修改重复日程为非重复示例代码:
// 更新一个系统日历的日程
public updateSystemCalendar(ids: number []) {
if (!this.systemCalendar) {
return;
}
if (!ids || ids.length === 0) {
return;
}
ids.forEach((item: number) => {
const date: Date = new Date();
const title = `不重复日程-更新-${item}`;
const startTime = date.getTime() + 10 * 60 * 1000;
const endTime = startTime + 30 * 60 * 1000;
const calendarEvent: calendarManager.Event = {
type: calendarManager.EventType.NORMAL,
id: item,
startTime: startTime,
endTime: endTime,
title: title,
reminderTime: [0],
recurrenceRule: {
recurrenceFrequency: calendarManager.RecurrenceFrequency.DAILY,
count: 1,
expire: endTime
}
};
this.systemCalendar?.updateEvent(calendarEvent, (err: BusinessError) => {
if (!err) {
this.calendarEventId = this.calendarEventId.filter((num) => num !== item);
}
});
});
}
Q:如何更新指定日程信息?
A:可以按照日程id进行指定日程的更新,更新日程相关信息。
示例如下:
// 更新一个系统日历的日程
public updateSystemCalendar(ids: number []) {
if (!this.systemCalendar) {
return;
}
if (!ids || ids.length === 0) {
return;
}
ids.forEach((item: number) => {
const date: Date = new Date();
const title = `不重复日程-更新-${item}`;
const startTime = date.getTime() + 10 * 60 * 1000;
const endTime = startTime + 30 * 60 * 1000;
const calendarEvent: calendarManager.Event = {
type: calendarManager.EventType.NORMAL,
id: item,
startTime: startTime,
endTime: endTime,
title: title,
reminderTime: [0],
recurrenceRule: {
recurrenceFrequency: calendarManager.RecurrenceFrequency.DAILY,
count: 1,
expire: endTime
}
};
this.systemCalendar?.updateEvent(calendarEvent, (err: BusinessError) => {
if (!err) {
this.calendarEventId = this.calendarEventId.filter((num) => num !== item);
}
});
});
}