iOS时间规则EKRecurrenceRule简单使用

写作原因：到第二家公司的时候首次看到我们的日程有这个功能，之前都没有用到过：

时间规则选择.gif

这是一个周期规则功能类；开始觉得很难，所以重构工程我把这个界面放到了偏后面；再加上我在上没有搜到相关的文章：

没有类似文章.png

所以我就想着自己写一篇，如果你们需要这个控制器或者文中提到的规则时间计算库可以在 https://git.oschina.net/liyongshi.com/EKRecurrenceRuleDemo.git 下载

类简单预览

- (instancetype)initRecurrenceWithFrequency:(EKRecurrenceFrequency)type
                         interval:(NSInteger)interval 
                    daysOfTheWeek:(nullable NSArray *)days
                   daysOfTheMonth:(nullable NSArray *)monthDays
                  monthsOfTheYear:(nullable NSArray *)months
                   weeksOfTheYear:(nullable NSArray *)weeksOfTheYear
                    daysOfTheYear:(nullable NSArray *)daysOfTheYear
                     setPositions:(nullable NSArray *)setPositions
                              end:(nullable EKRecurrenceEnd *)end

绝大多数时候都是使用这个初始化函数，我们会按照type的不同来选择性的填写初始化参数；我们先来看看各参数是什么意思

type
typedef NS_ENUM(NSInteger, EKRecurrenceFrequency) {
    EKRecurrenceFrequencyDaily,//按天
    EKRecurrenceFrequencyWeekly,//按周
    EKRecurrenceFrequencyMonthly,//按月
    EKRecurrenceFrequencyYearly//按年
};

重复规则

interval

间隔单位，会根据type的不同用法也不一样

days

EKRecurrenceDayOfWeek类型，表示星期一、星期二...星期日，可以传入多个值

monthDays

一个月中的几号，可以传入多个值

months

一年中的几月，可以传入多个值

weeksOfTheYear

一年中的多少周，可以传入多个值

daysOfTheYear

一年中的多少号，可以传入多个值

setPositions

规则之外的数字，也就是除了上面的规则我还需要这些点也触发执行

end

EKRecurrenceEnd类型，标示规则结束；有次数（如只执行10次）和时间（如该时间后不再计算）两个选择

下面我就讲讲我的规则选择界面（文章开头的gif图）都填充了哪些参数来初始化；我们假设需要执行规则的时间为：2016-12-01到2016-12-31中的早上8:30到晚上6:30；下面我们以type的四种情况开始讲

EKRecurrenceFrequencyDaily

当type为EKRecurrenceFrequencyDaily时，填充interval和days
一：interval为6，days为nil；也就是每6天执行一次
我们用一个库来计算出所有的事件开始时间得到如下结果：

<__NSArrayM 0x600000455a80>(
2016-12-06 08:30:00 +0000,
2016-12-12 08:30:00 +0000,
2016-12-18 08:30:00 +0000,
2016-12-24 08:30:00 +0000,
2016-12-30 08:30:00 +0000
)

这个结果刚好就是每隔6天执行一次
二：interval为1，days为星期一...星期五；也就是每个工作日执行一次

<__NSArrayM 0x61000025e390>(
2016-12-01 08:30:00 +0000,
2016-12-02 08:30:00 +0000,
2016-12-05 08:30:00 +0000,
2016-12-06 08:30:00 +0000,
2016-12-07 08:30:00 +0000,
...
2016-12-26 08:30:00 +0000,
2016-12-27 08:30:00 +0000,
2016-12-28 08:30:00 +0000,
2016-12-29 08:30:00 +0000,
2016-12-30 08:30:00 +0000
)

EKRecurrenceFrequencyWeekly

当type为EKRecurrenceFrequencyWeekly时，填充interval和days；
一：interval为2，days为星期一和星期四；也就是我要每隔两周的星期一和星期四执行一次
我们将会得到如下结果：

<__NSArrayM 0x60800044f660>(
2016-12-01 08:30:00 +0000,
2016-12-12 08:30:00 +0000,
2016-12-15 08:30:00 +0000,
2016-12-26 08:30:00 +0000,
2016-12-29 08:30:00 +0000
)

EKRecurrenceFrequencyMonthly

当type为EKRecurrenceFrequencyWeekly时，填充interval和monthDays；
一：interval为1，monthDays为6；也就是每一个月的6号执行一次
我们得到：

<__NSArrayM 0x610000252150>(
2016-12-06 08:30:00 +0000
)

因为我们规定的时间只有12月，所以只有一个时间

EKRecurrenceFrequencyYearly

当type为EKRecurrenceFrequencyWeekly时，填充interval、monthDays和months，其中interval设置为1
一：monthDays为8，months为12；也就是每年的12月8号执行一次
我们会得到：

<__NSArrayM 0x618000453ef0>(
2016-12-08 08:30:00 +0000
)

结果当然也是对的，到现在我上面的规则选择界面就可以做出来了

补充

因为我们工程的规则选择界面还是比较简单的，所以就如上面所说就可以完成需求了；当然你也可以研究一些比较复杂的规则，不过一般上面这些已经够用了