前言
我们可以使用系统提供的eventkit框架来访问和操作用户的日历日程和提醒（虽然日历和提醒是两个独立的app，但是是用同一个框架来处理数据）。同样地，日历和提醒的数据的数据，都是存储在同一个叫做calendar database的数据库中：
eventkit不仅能获取已存在的日程和提醒，还能在自己的app中创建、编辑、删除用户的日程和提醒，还能添加提醒、监听变化等。
在ios10+中，若要访问用户日程或提醒，需要在info.plist中分别添加nsremindersusagedescription和nscalendarsusagedescription
一. 读取日程
我们可以通过ekeventstore类来对用户的calendar database进行查询、创建、编辑、删除等操作。我们可以使用条件来获取符合条件的一组日程，也可以用唯一标识来获取指定的一条日程。获取到的每一条日程都是一个ekevent的实例对象，因此我们修改ekevent对象的属性即可实现修改日程信息。
1.创建连接
|
1
2
3
|
#import <eventkit/eventkit.h>
...
ekeventstore *store = [[ekeventstore alloc] init];
|
ekeventstore对象的创建和释放会比较耗时，因此我们一般会在app加载后只创建一个event store对象。
2.通过条件获取日程
如果要获取一个时间段内的日程，可以使用ekeventstore对象的eventsmatchingpredicate: 方法。下面代码演示如何获取昨天至一年后的所有日程：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
// 获取日历对象
nscalendar *calendar = [nscalendar currentcalendar];
// 创建开始时间
nsdatecomponents *onedayagocomponents = [[nsdatecomponents alloc] init];
onedayagocomponents.day = -1;
nsdate *onedayago = [calendar datebyaddingcomponents:onedayagocomponents
todate:[nsdate date]
options:0];
// 创建结束时间
nsdatecomponents *oneyearfromnowcomponents = [[nsdatecomponents alloc] init];
oneyearfromnowcomponents.year = 1;
nsdate *oneyearfromnow = [calendar datebyaddingcomponents:oneyearfromnowcomponents
todate:[nsdate date]
options:0];
// 创建条件
nspredicate *predicate = [store predicateforeventswithstartdate:onedayago enddate:oneyearfromnow calendars:nil];
// 获得符合条件的所有日程
nsarray *events = [store eventsmatchingpredicate:predicate];
|
3.批量处理日程
如果需要批量处理得到的日程，可以用ekeventstore
实例的enumerateeventsmatchingpredicate:usingblock:方法（同步方法，为了不阻塞主线程建议在其它线程中执行），例如打印出所有符合条件的日程标题：
|
1
2
3
|
[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”：
|
1
2
|
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 - 重复规则
实例代码：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
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添加日程
|
1
2
3
4
5
6
7
|
#import <eventkitui/eventkitui.h>
...
ekeventeditviewcontroller *vc = [[ekeventeditviewcontroller alloc] init];
vc.eventstore = store;
vc.editviewdelegate = self;
[self presentviewcontroller:vc animated:yes completion:nil];
|
通过实现ekeventeditviewdelegate代理事件获得结果：
|
1
2
3
4
|
- (void)eventeditviewcontroller:(ekeventeditviewcontroller *)controller didcompletewithaction:(ekeventeditviewaction)action{
nslog(@"添加日程结果：%zd",action);
[self dismissviewcontrolleranimated:yes completion:nil];
}
|
三.编辑和删除日程
我们可以通过修改event的属性值来对日程进行编辑，最后需要调用ekeventstore的实例方法saveevent:span:commit:error:进行持久化保存：
|
1
2
3
|
event.title = @"修改后的标题";
nserror *error;
[store saveevent:event span:ekspanfutureevents commit:yes error:&error];
|
通过ekeventstore的实例方法removeevent:span:commit:error:.来删除日程：
|
1
2
|
nserror *error;
[store removeevent:event span:ekspanfutureevents error:&error];
|
四.添加提醒
我们可以给日程添加本地推送提醒，在指定的时间或地点给用户进行提醒。
1.基于时间的提醒
我们可以通过event的 addalarm:方法为一个日程添加提醒。我们可以指定一个确切时间或一个相对时间（只能是日程开始时间之前）。通过removealarm: 方法可将提醒移除。
如在开始时间前10分钟提醒：
|
1
|
[event addalarm:[ekalarm alarmwithrelativeoffset:-10*60]];
|
2.基于地理位置的提醒
我们可以设定当用户进入或离开指定的地理位置区域时，触发日程提醒。例如当用户离开公司，提醒用户需要到超市购买日用品，作为开发者，需要确定一个经纬度以及一个半径范围。
|
1
2
3
4
5
6
7
|
ekalarm *alarm = [[ekalarm alloc] init];
ekstructuredlocation *location = [ekstructuredlocation
locationwithtitle:@"current location"];
location.geolocation = [[cllocation alloc] initwithlatitude:23.1754700000 longitude:113.4147400000];
alarm.structuredlocation = location;
alarm.proximity = ekalarmproximityenter;
[event addalarm:alarm];
|
参考苹果官方文档
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持服务器之家。
原文链接：https://blog.csdn.net/dolacmeng/article/details/73295240