ITPub博客

首页 > IT职业 > IT职场 > iOS时间规则EKRecurrenceRule简单使用

iOS时间规则EKRecurrenceRule简单使用

IT职场 作者:HEDAODI 时间:2021-09-09 09:19:28 0 删除 编辑

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

图片描述

时间规则选择.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的不同来选择性的填写初始化参数;我们先来看看各参数是什么意思

typetypedef 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>(
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>(
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>(
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>(
2016-12-06 08:30:00 +0000
)

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

EKRecurrenceFrequencyYearly

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

<__nsarraym>(
2016-12-08 08:30:00 +0000
)

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

补充

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



作者:Thebloodelves
链接:https://www.jianshu.com/p/3f8c13634a82


来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/1354/viewspace-2802187/ ,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论

注册时间:2019-04-15

  • 博文量
    107
  • 访问量
    1129