iOS實(shí)現(xiàn)日歷行程的增刪改查

更新時(shí)間：2021年08月25日 16:17:10 作者：imJackXu

這篇文章主要為大家詳細(xì)介紹了iOS實(shí)現(xiàn)日歷行程的增刪改查，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下

前言

我們可以使用系統(tǒng)提供的EventKit框架來(lái)訪問(wèn)和操作用戶的日歷日程和提醒（雖然日歷和提醒是兩個(gè)獨(dú)立的app，但是是用同一個(gè)框架來(lái)處理數(shù)據(jù)）。同樣地，日歷和提醒的數(shù)據(jù)的數(shù)據(jù)，都是存儲(chǔ)在同一個(gè)叫做Calendar Database的數(shù)據(jù)庫(kù)中：

EventKit不僅能獲取已存在的日程和提醒，還能在自己的app中創(chuàng)建、編輯、刪除用戶的日程和提醒，還能添加提醒、監(jiān)聽(tīng)變化等。

在iOS10+中，若要訪問(wèn)用戶日程或提醒，需要在info.plist中分別添加NSRemindersUsageDescription和NSCalendarsUsageDescription

一. 讀取日程

我們可以通過(guò)EKEventStore類來(lái)對(duì)用戶的Calendar database進(jìn)行查詢、創(chuàng)建、編輯、刪除等操作。我們可以使用條件來(lái)獲取符合條件的一組日程，也可以用唯一標(biāo)識(shí)來(lái)獲取指定的一條日程。獲取到的每一條日程都是一個(gè)EKEvent的實(shí)例對(duì)象，因此我們修改EKEvent對(duì)象的屬性即可實(shí)現(xiàn)修改日程信息。

1.創(chuàng)建連接

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

EKEventStore對(duì)象的創(chuàng)建和釋放會(huì)比較耗時(shí)，因此我們一般會(huì)在app加載后只創(chuàng)建一個(gè)event store對(duì)象。

2.通過(guò)條件獲取日程

如果要獲取一個(gè)時(shí)間段內(nèi)的日程，可以使用EKEventStore對(duì)象的eventsMatchingPredicate: 方法。下面代碼演示如何獲取昨天至一年后的所有日程：

// 獲取日歷對(duì)象
NSCalendar *calendar = [NSCalendar currentCalendar];

// 創(chuàng)建開(kāi)始時(shí)間
NSDateComponents *oneDayAgoComponents = [[NSDateComponents alloc] init];
oneDayAgoComponents.day = -1;
NSDate *oneDayAgo = [calendar dateByAddingComponents:oneDayAgoComponents
                                              toDate:[NSDate date]
                                             options:0];

// 創(chuàng)建結(jié)束時(shí)間
NSDateComponents *oneYearFromNowComponents = [[NSDateComponents alloc] init];
oneYearFromNowComponents.year = 1;
NSDate *oneYearFromNow = [calendar dateByAddingComponents:oneYearFromNowComponents
                                                   toDate:[NSDate date]
                                                  options:0];

// 創(chuàng)建條件
NSPredicate *predicate = [store predicateForEventsWithStartDate:oneDayAgo endDate:oneYearFromNow calendars:nil];

// 獲得符合條件的所有日程
NSArray *events = [store eventsMatchingPredicate:predicate];

3.批量處理日程

如果需要批量處理得到的日程，可以用EKEventStore
實(shí)例的enumerateEventsMatchingPredicate:usingBlock:方法（同步方法，為了不阻塞主線程建議在其它線程中執(zhí)行），例如打印出所有符合條件的日程標(biāo)題：

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

4.通過(guò)唯一標(biāo)識(shí)獲取日程

每一個(gè)日程都有只讀的唯一標(biāo)識(shí)屬性eventIdentifier，我們可以通過(guò)EKEventStore對(duì)象的eventWithIdentifier:方法，傳入唯一標(biāo)識(shí)獲取指定的一個(gè)日程（這個(gè)標(biāo)識(shí)是只讀屬性，由系統(tǒng)指定，可以通過(guò)前面的條件查詢獲取，也可以在創(chuàng)建新的日程時(shí)保存這個(gè)唯一標(biāo)識(shí)），例如我們已經(jīng)知道一個(gè)日程的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);

二.創(chuàng)建日程

1.通過(guò)代碼創(chuàng)建

通過(guò)EKEvent對(duì)象的eventWithEventStore:來(lái)創(chuàng)建一個(gè)日程，并通過(guò)對(duì)應(yīng)的屬性編輯日程詳細(xì)信息，部分屬性如：

title - 日程的標(biāo)題
startDate - 日程的開(kāi)始日期
endDate - 日程的結(jié)束日期
calendar - 日程對(duì)應(yīng)的日歷
alarms - 日程的提醒時(shí)間
recurrenceRules - 重復(fù)規(guī)則

實(shí)例代碼：

EKEvent *event = [EKEvent eventWithEventStore:store];
event.title = @"代碼創(chuàng)建的日程";
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.通過(guò)系統(tǒng)日歷ui添加日程

#import <EventKitUI/EventKitUI.h>
...

EKEventEditViewController *vc = [[EKEventEditViewController alloc] init];
vc.eventStore = store;
vc.editViewDelegate = self;
[self presentViewController:vc animated:YES completion:nil];

通過(guò)實(shí)現(xiàn)EKEventEditViewDelegate代理事件獲得結(jié)果：

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

三.編輯和刪除日程

我們可以通過(guò)修改event的屬性值來(lái)對(duì)日程進(jìn)行編輯，最后需要調(diào)用EKEventStore的實(shí)例方法saveEvent:span:commit:error:進(jìn)行持久化保存：

event.title = @"修改后的標(biāo)題";
NSError *error;
[store saveEvent:event span:EKSpanFutureEvents commit:YES error:&error];

通過(guò)EKEventStore的實(shí)例方法removeEvent:span:commit:error:.來(lái)刪除日程：

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

四.添加提醒

我們可以給日程添加本地推送提醒，在指定的時(shí)間或地點(diǎn)給用戶進(jìn)行提醒。

1.基于時(shí)間的提醒

我們可以通過(guò)event的 addAlarm:方法為一個(gè)日程添加提醒。我們可以指定一個(gè)確切時(shí)間或一個(gè)相對(duì)時(shí)間（只能是日程開(kāi)始時(shí)間之前）。通過(guò)removeAlarm: 方法可將提醒移除。
如在開(kāi)始時(shí)間前10分鐘提醒：

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

2.基于地理位置的提醒

我們可以設(shè)定當(dāng)用戶進(jìn)入或離開(kāi)指定的地理位置區(qū)域時(shí)，觸發(fā)日程提醒。例如當(dāng)用戶離開(kāi)公司，提醒用戶需要到超市購(gòu)買日用品，作為開(kāi)發(fā)者，需要確定一個(gè)經(jīng)緯度以及一個(gè)半徑范圍。

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];

參考蘋果官方文檔

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: