当前位置：首页 > 编程日记 > 正文

【iOS】日历行程的增删改查（完整）

编程日记 2024-08-19 19:30:00

前言

我们可以使用系统提供的EventKit框架来访问和操作用户的日历日程和提醒（虽然日历和提醒是两个独立的app，但是是用同一个框架来处理数据）。同样地，日历和提醒的数据的数据，都是存储在同一个叫做Calendar Database的数据库中：

官方示意图

EventKit不仅能获取已存在的日程和提醒，还能在自己的app中创建、编辑、删除用户的日程和提醒，还能添加提醒、监听变化等。

在iOS10+中，若要访问用户日程或提醒，需要在info.plist中分别添加NSRemindersUsageDescription和NSCalendarsUsageDescription

一. 读取日程

我们可以通过EKEventStore类来对用户的Calendar database进行查询、创建、编辑、删除等操作。我们可以使用条件来获取符合条件的一组日程，也可以用唯一标识来获取指定的一条日程。获取到的每一条日程都是一个EKEvent的实例对象，因此我们修改EKEvent对象的属性即可实现修改日程信息。

1.创建连接

#import <EventKit/EventKit.h>
...
EKEventStore *store = [[EKEventStore alloc] init];

EKEventStore对象的创建和释放会比较耗时，因此我们一般会在app加载后只创建一个event store对象。

2.通过条件获取日程
如果要获取一个时间段内的日程，可以使用EKEventStore对象的eventsMatchingPredicate: 方法。下面代码演示如何获取昨天至一年后的所有日程：

// 获取日历对象
NSCalendar *calendar = [NSCalendar currentCalendar];// 创建开始时间
NSDateComponents *oneDayAgoComponents = [[NSDateComponents alloc] init];
oneDayAgoComponents.day = -1;
NSDate *oneDayAgo = [calendar dateByAddingComponents:oneDayAgoComponentstoDate:[NSDate date]options:0];// 创建结束时间
NSDateComponents *oneYearFromNowComponents = [[NSDateComponents alloc] init];
oneYearFromNowComponents.year = 1;
NSDate *oneYearFromNow = [calendar dateByAddingComponents:oneYearFromNowComponentstoDate:[NSDate date]options:0];// 创建条件
NSPredicate *predicate = [store predicateForEventsWithStartDate:oneDayAgo endDate:oneYearFromNow calendars:nil];// 获得符合条件的所有日程
NSArray *events = [store eventsMatchingPredicate:predicate];

3.批量处理日程
如果需要批量处理得到的日程，可以用EKEventStore
实例的enumerateEventsMatchingPredicate:usingBlock:方法（同步方法，为了不阻塞主线程建议在其它线程中执行），例如打印出所有符合条件的日程标题：

[store enumerateEventsMatchingPredicate:predicate usingBlock:^(EKEvent * _Nonnull event, BOOL * _Nonnull stop) {NSLog(@"event:%@",event.title);
}];

4.通过唯一标识获取日程

每一个日程都有只读的唯一标识属性eventIdentifier，我们可以通过EKEventStore对象的eventWithIdentifier:方法，传入唯一标识获取指定的一个日程（这个标识是只读属性，由系统指定，可以通过前面的条件查询获取，也可以在创建新的日程时保存这个唯一标识），例如我们已经知道一个日程的eventIdentifier值为”D8574A98-A929-4A92-8E9F-048F46FB5DE7:717c8b40-44e3-31ab-8243-2d5918e266ef”：

EKEvent *event = [store eventWithIdentifier:@"D8574A98-A929-4A92-8E9F-048F46FB5DE7:717c8b40-44e3-31ab-8243-2d5918e266ef"];
NSLog(@"event:%@",event);

二.创建日程

1.通过代码创建

通过EKEvent对象的eventWithEventStore:来创建一个日程，并通过对应的属性编辑日程详细信息，部分属性如：

title - 日程的标题
startDate - 日程的开始日期
endDate - 日程的结束日期
calendar - 日程对应的日历
alarms - 日程的提醒时间
recurrenceRules - 重复规则

实例代码：

EKEvent *event = [EKEvent eventWithEventStore:store];
event.title = @"代码创建的日程";
event.calendar = [store defaultCalendarForNewEvents];
NSCalendar *calendar = [NSCalendar currentCalendar];
NSDateComponents *components = [[NSDateComponents alloc] init];
components.hour = 1;
NSDate *endTime = [calendar dateByAddingComponents:components toDate:[NSDate date] options:0];
event.startDate = [NSDate date];
event.endDate = endTime;
event.notes = @"档期详情：hyaction://hunyu-music";
[event addAlarm:[EKAlarm alarmWithRelativeOffset:-10*60]];NSError *error;
[store saveEvent:event span:EKSpanFutureEvents commit:YES  error:&error];
if (!error) {NSLog(@"添加成功！");
}else{NSLog(@"添加失败：%@",error);
}

2.通过系统日历ui添加日程

#import <EventKitUI/EventKitUI.h>
...EKEventEditViewController *vc = [[EKEventEditViewController alloc] init];
vc.eventStore = store;
vc.editViewDelegate = self;
[self presentViewController:vc animated:YES completion:nil];

通过实现EKEventEditViewDelegate代理事件获得结果：

- (void)eventEditViewController:(EKEventEditViewController *)controller didCompleteWithAction:(EKEventEditViewAction)action{NSLog(@"添加日程结果：%zd",action);[self dismissViewControllerAnimated:YES completion:nil];
}

三.编辑和删除日程

我们可以通过修改event的属性值来对日程进行编辑，最后需要调用EKEventStore的实例方法saveEvent:span:commit:error:进行持久化保存：

event.title = @"修改后的标题";
NSError *error;
[store saveEvent:event span:EKSpanFutureEvents commit:YES error:&error];

通过EKEventStore的实例方法removeEvent:span:commit:error:.来删除日程：

NSError *error;
[store removeEvent:event span:EKSpanFutureEvents error:&error];

四.添加提醒

我们可以给日程添加本地推送提醒，在指定的时间或地点给用户进行提醒。

1.基于时间的提醒
我们可以通过event的 addAlarm:方法为一个日程添加提醒。我们可以指定一个确切时间或一个相对时间（只能是日程开始时间之前）。通过removeAlarm: 方法可将提醒移除。
如在开始时间前10分钟提醒：

[event addAlarm:[EKAlarm alarmWithRelativeOffset:-10*60]];

2.基于地理位置的提醒

我们可以设定当用户进入或离开指定的地理位置区域时，触发日程提醒。例如当用户离开公司，提醒用户需要到超市购买日用品，作为开发者，需要确定一个经纬度以及一个半径范围。

EKAlarm *alarm = [[EKAlarm alloc] init];EKStructuredLocation *location = [EKStructuredLocationlocationWithTitle:@"Current Location"];
location.geoLocation = [[CLLocation alloc] initWithLatitude:23.1754700000 longitude:113.4147400000];
alarm.structuredLocation = location;
alarm.proximity = EKAlarmProximityEnter;
[event addAlarm:alarm];

参考苹果官方文档：
https://developer.apple.com/library/content/documentation/DataManagement/Conceptual/EventKitProgGuide/Introduction/Introduction.html

https://www.dkcj.cn/info/14986.html

【iOS】日历行程的增删改查（完整）

前言

一. 读取日程

二.创建日程

三.编辑和删除日程

四.添加提醒

相关文章：

ntp 、ntpdate 、chrony 时间同步

贝塞尔曲线动画demo（仿美人相机效果）

算法---001

IOS笔记 #pragma mark的用法

shell脚本api接口考虑并发问题的可行性操作

ZOJ 2110 Tempter of the Bone（DFS）

java 16 -12 静态导入

Quartz 2D Programming Guide笔记

有关运维面试重点

微信应用号开发知识贮备之altjs官方实例初探

Oracle DMP 操作笔记之根据DMP逆向推导出导出的表空间名称

【iOS】中间透明的引导蒙层

python连接数据库，处理数据结果后生成excel文件

WhyGL:一套学习OpenGL的框架,及翻写Nehe的OpenGL教程

iOS与JS交互的4种方法

UDP打洞原理

五款常用协议分析处理工具推荐

【转】android电池（四）：电池电量计(MAX17040)驱动分析篇

hihoCoder#1384 : Genius ACM

微信小程序开发笔记

简单两行，实现无线WiFi共享上网，手机抓包再也不用愁了

用C#实现的条形码和二维码编码解码器

【iOS】通过NSURLProtocol提高Web加载速度

rand()和srand()关系很简单——一看就明白(通过一个可移植的源码)

Windows下Python 3.6 安装BeautifulSoup库

struts2配置详解

Xcode调试技巧

MiniGUI - UNIX Domain Socket 封装

RSA加密算法破解及原理

SpringMvc之@RequestParam详解