iOS增、删、改、查系统提醒事件和日历事件

作者: mian小爬 | 来源:发表于2018-04-12 17:26 被阅读369次

前言

1、引入EventKit框架。 (EventKit框架使你能访问用户的Calendar(日历)和Reminder(提醒事项)信息。他们使用相同的库（EKEventStore）处理数据，该库管理所有event数据。该框架除了允许检索用户已经存在的calendar和reminder数据外，还允许创建新的事件和提醒)
2、将EKEventStore对象写成单例。 （因为需要频繁调用EKEventStore对象，可以将EKEventStore对象写成单例）
3、设置访问日历的权限NSCalendarsUsageDescription。（iOS10之后，要用到某个权限必须在info.plist里指明，否则会引起崩溃和审核失败）

检测日历功能是否可以使用

检查授权状态：

EKAuthorizationStatus eventStatus = [EKEventStore  authorizationStatusForEntityType:EKEntityTypeEvent];
其中eventStatus为
EKAuthorizationStatusNotDetermined = 0,// 未进行授权选择
EKAuthorizationStatusRestricted,//未授权，且用户无法更新，如家长控制情况下
EKAuthorizationStatusDenied,　　　　　　 // 用户拒绝App使用
EKAuthorizationStatusAuthorized,　　　// 已授权，可使用

在“未进行授权”的情况下弹出提示框，提示用户授权：

[self.eventStore requestAccessToEntityType:EKEntityTypeEvent completion:^(BOOL granted, NSError * _Nullable error) {
      
 }];

完整代码：

// 检测日历功能是否可以使用
- (void)checkCalendarCanUsedCompletion:(completion)completion{
//    EKEntityTypeEvent日历事件
//    EKEntityTypeReminder提醒事项
    self.completion = completion;
    EKAuthorizationStatus eventStatus = [EKEventStore  authorizationStatusForEntityType:EKEntityTypeEvent];
    if (eventStatus == EKAuthorizationStatusAuthorized) {
        if (self.completion) {
            self.completion(YES, nil);
        }
    }else if(eventStatus == EKAuthorizationStatusNotDetermined){
        __block  BOOL isGranted = NO;
        __block  NSError *isError;
        [self.eventStore requestAccessToEntityType:EKEntityTypeEvent completion:^(BOOL granted, NSError * _Nullable error) {
            isGranted = granted;
            isError = error;
            if (granted) {
                NSLog(@"用户点击了允许访问日历");
            }else{
                NSLog(@"用户没有点允许访问日历");
            }
        }];
        if(self.completion){
            self.completion(isGranted, isError);
        }
    }
}

添加日历提醒事项

保存日历事件：

[self.eventStore saveEvent:event span:EKSpanThisEvent commit:YES error:&err];

commit：yes:表示立即把此次操作提交到系统事件库，NO表示此时不提交。如果一次性操作的事件数比较少的话，可以每次都传YES，实时更新事件数据库。如果一次性操作的事件较多的话，可以每次传NO，最后再执行一次提交所有更改到数据库，把原来的更改全部提交到数据库，不管是添加还是删除。
EKSpanThisEvent：表示只影响当前事件。 EKSpanFutureEvents 表示影响当前和以后的所有事件。比如某条重复任务修改后保存时，传EKSpanThisEvent表示值修改这一条重复事件。传EKSpanFutureEvents表示修改这一条和以后的所有重复事件。删除事件时，分别表示删除这一条；删除这一条和以后的所有。

完整代码：

- (void)createEventCalendarTitle:(NSString *)title addLocation:(NSString *)location addStartDate:(NSDate *)startDate addEndDate:(NSDate *)endDate addAllDay:(BOOL)allDay addAlarmArray:(NSArray *)alarmArray addCompletion:(completion)completion{
    self.completion = completion;
    if ([self.eventStore respondsToSelector:@selector(requestAccessToEntityType:completion:)])
    {
        [self.eventStore requestAccessToEntityType:EKEntityTypeEvent completion:^(BOOL granted, NSError *error){
            dispatch_async(dispatch_get_main_queue(), ^{
                if (error){

                }else if (!granted){

                }else{
                    EKEvent *event  = [EKEvent eventWithEventStore:self.eventStore];
                    event.title = title;
                    event.location = location;
                    NSDateFormatter *tempFormatter = [[NSDateFormatter alloc]init];
                    [tempFormatter setDateFormat:@"dd.MM.yyyy HH:mm"];
                    event.startDate = startDate;
                    event.endDate   = endDate;
                    // 是否设置全天
                    event.allDay = allDay;
                    //添加提醒
                    if (alarmArray && alarmArray.count > 0) {
                        for (NSString *timeString in alarmArray) {
                            [event addAlarm:[EKAlarm alarmWithRelativeOffset:[timeString integerValue]]];
                        }
                    }
                    //默认日历类型
                    [event setCalendar:[self.eventStore defaultCalendarForNewEvents]];
                    // 保存日历
                    NSError *err;
                    [self.eventStore saveEvent:event span:EKSpanThisEvent commit:YES error:&err];
                    if (self.completion) {
                        self.completion(granted,error);
                    }
                }
            });
        }];
    }
}

    其中EKEvent属性：
    title - 日程的标题
    startDate - 日程的开始日期
    endDate - 日程的结束日期
    calendar - 日程对应的日历
    alarms - 日程的闹钟提醒
    eventIdentifier:唯一标识符区分某个事件，只读
    recurrenceRules - 重复规则，默认不重复
    -  alarms:
    通过event的addAlarm:方法为一个日程添加提醒，指定一个确切时间或一个相对时间。     
    通过removeAlarm: 方法可将提醒移除。
    -  recurrenceRules:
    用initRecurrenceWithFrequency:interval:end:方法创建一个EKRecurrenceRule对象。
    1）EKRecurrenceFrequency类型，指示recurrence是daily、weekly、monthly或yearly.
    2)  interval: 这是一个大于0的整数，来制定重复的间隔。例如，如果recurrence rule是
        weekly，并且recurrence interval是1，然后重复模式为每星期都重复。如果
       recurrence interval是3，那么是每3个星期重复一次。    
    3） end: 这是个可选参数，代表何时终止。

查询日历事件

查询所有的日历事件，包括家庭，工作，生日，中国节假日类型等

NSArray *tempA = [self.eventStore calendarsForEntityType:EKEntityTypeEvent];

谓词查询

NSPredicate *predicate = [self.eventStore predicateForEventsWithStartDate:startDate endDate:endDate calendars:only3D];
// 获取到范围内的所有事件
NSArray *request = [self.eventStore eventsMatchingPredicate:predicate];

EKEventStore的eventsMatchingPredicate:方法获取属于你提供的谓词中指定的日期范围的所有事件。

完整代码
（modifytitle ：有值则查询此日期内标题为modifytitle的日历事件，无则查询此日期内全部日历事件）

// 查日历事件：startDate/endDate : 开始/结束时间 modifytitle:标题，为空则都要查询
- (NSArray *)checkToStartDate:(NSDate *)startDate addEndDate:(NSDate *)endDate addModifytitle:(NSString *)modifytitle{
    // 查询到所有的日历
    NSArray *tempA = [self.eventStore calendarsForEntityType:EKEntityTypeEvent];
    NSMutableArray *only3D = [NSMutableArray array];
    for (int i = 0 ; i < tempA.count; i ++) {
        EKCalendar *temCalendar = tempA[i];
        EKCalendarType type = temCalendar.type;
        // 工作、家庭和本地日历
        if (type == EKCalendarTypeLocal || type == EKCalendarTypeCalDAV) {
            [only3D addObject:temCalendar];
        }
    }
    NSPredicate *predicate = [self.eventStore predicateForEventsWithStartDate:startDate endDate:endDate calendars:only3D];
    // 获取到范围内的所有事件
    NSArray *request = [self.eventStore eventsMatchingPredicate:predicate];
    // 按开始事件进行排序
    request = [request sortedArrayUsingSelector:@selector(compareStartDateWithEvent:)];
    if (!modifytitle || [modifytitle isEqualToString:@""]) {
       return request;
    }else{
        NSMutableArray *onlyRequest = [NSMutableArray array];
        for (int i = 0; i < request.count; i++) {
            EKEvent *event = request[i];
            if (event.title && [event.title isEqualToString:modifytitle]) {
                [onlyRequest addObject:event];
            }
        }
        return onlyRequest;
    }
}

删除日历事件

删除日历事件

// commit:NO：最后再一次性提交
 [self.eventStore removeEvent:event span:EKSpanThisEvent commit:NO error:&error];

一次提交所有操作到事件库

NSError *errored = nil;
BOOL commitSuccess= [self.eventStore commit:&errored];
return commitSuccess;

完整代码：

// 删除日历事件
- (BOOL)deleteCalendarStartDate:(NSDate *)startDate addEndDate:(NSDate *)endDate addModifytitle:(NSString *)modifytitle{
    // 获取到此事件
    NSArray *request = [self checkToStartDate:startDate addEndDate:endDate addModifytitle:modifytitle];
    
    for (int i = 0; i < request.count; i ++) {
        // 删除这一条事件
        EKEvent *event = request[i];
        [event setCalendar:[self.eventStore defaultCalendarForNewEvents]];
        NSError*error =nil;
        
        // commit:NO：最后再一次性提交
        [self.eventStore removeEvent:event span:EKSpanThisEvent commit:NO error:&error];
    }
    //一次提交所有操作到事件库
    NSError *errored = nil;
    BOOL commitSuccess= [self.eventStore commit:&errored];
    return commitSuccess;
}

修改日历事件

查询是否有此日历，没有则添加，有则先删除后添加来实现修改
完整代码

// 修改日历
- (void)modifyCalendarCalendarTitle:(NSString *)title addLocation:(NSString *)location addModifytitle:(NSString *)modifytitle addStartDate:(NSDate *)startDate addEndDate:(NSDate *)endDate addAllDay:(BOOL)allDay addAlarmArray:(NSArray *)alarmArray addCompletion:(completion)completion{
    // 获取到此事件
    NSArray *request = [self checkToStartDate:startDate addEndDate:endDate addModifytitle:modifytitle];
    if (request.count > 0 ) {
        for (int i = 0; i < request.count; i++) {
            [self deleteCalendarStartDate:startDate addEndDate:endDate addModifytitle:modifytitle];
        
            [self createEventCalendarTitle:title addLocation:location addStartDate:startDate addEndDate:endDate addAllDay:allDay addAlarmArray:alarmArray addCompletion:completion];
        }
    }else{
        // 没有此条日历
        [self createEventCalendarTitle:title addLocation:location addStartDate:startDate addEndDate:endDate addAllDay:allDay addAlarmArray:alarmArray addCompletion:completion];
    }
}

工具类（ViewController是注释掉的例子）
WMEventCalendarDemo

iOS增、删、改、查系统提醒事件和日历事件

前言

检测日历功能是否可以使用

添加日历提醒事项

查询日历事件

删除日历事件

修改日历事件

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

iOS基础