且构网

分享程序员开发的那些事...
且构网 - 分享程序员编程开发的那些事

iCalendar格式中关于RRule的解析和生成

更新时间:2021-07-19 05:04:07

最近在做一个关于Calendar的项目,相当于Google Calendar或者Outlook中的Calendar。在Calendar的发布和共享中,使用到了iCalendar,是一种日历数据交换的标准,具体参见***:http://zh.wikipedia.org/wiki/ICalendar

由于使用C#开发,所以希望能够找到一个开源或者免费的iCalendar组件,帮助生成.ics格式的文件。果然有人做了这样的事情,那就是DDay.iCal,开源地址:http://sourceforge.net/projects/dday-ical/

关于Calendar,普通的事件都好设置,最麻烦的就是循环事件。循环事件有多个属性需要设置,还要计算接下来发生的时间,但是在iCalendar标准中,这些循环设置,最终都化作为一个RRule格式的字符串(关于RRule格式的标准,我们可以参见http://www.kanzaki.com/docs/ical/rrule.html)。

既然是以DDay.iCal来生成ics文件,那么想必这个组件也有解析RRule格式和生成RRule格式的方法。下面就说说如果使用DDay.iCal处理RRule。

一、RRule的解析

DDay.iCal中有个RecurrencePattern对象,该对象可以用于描述循环设置。该对象在构造时可以传入RRule字符串,然后我们可以使用RecurringComponent对象的GetOccurrences方法获得循环事件在指定时间区间内的发生的时间。

闲话休说,我们看代码:

 RecurringComponent recurringComponent = new RecurringComponent();
 RecurrencePattern pattern = new RecurrencePattern("FREQ=WEEKLY;BYDAY=MO");//RRule设置为每周一发生
 recurringComponent.RecurrenceRules.Add(pattern);
 recurringComponent.Start = new iCalDateTime(Convert.ToDateTime("2013-6-1 00:00:00")); //该循环事件从6.1开始发生
 var occurrences = recurringComponent.GetOccurrences(
 Convert.ToDateTime("2013-6-30 23:59:59"),
 //我们虽然要取的是7.1号之后的事件,但是这里不能写成2013-7-1,因为该函数在计算时是>startTime <=endTime
 Convert.ToDateTime("2013-7-31 23:59:59")); //获得循环事件在7月份发生的具体时间 foreach (Occurrence occurrence in occurrences)
 {
 DateTime occurrenceTime = occurrence.Period.StartTime.Local;
 Console.WriteLine(occurrenceTime.ToString("yyyy-MM-dd"));
 }

二、RRule的生成

RRule还是通过RecurrencePattern来设置循环的属性,然后使用ToString方法就能够获得RRule字符串了。

代码如下:

RecurrencePattern pattern = new RecurrencePattern();
pattern.ByDay=new List<IWeekDay>(){new WeekDay(DayOfWeek.Sunday)};//每周周日发生
pattern.Frequency=FrequencyType.Weekly;//循环周期为周
Console.WriteLine(pattern.ToString());//生成RRule格式的字符串
 
RecurringComponent recurringComponent = new RecurringComponent();
recurringComponent.RecurrenceRules.Add(pattern);
recurringComponent.Start = new iCalDateTime(Convert.ToDateTime("2013-6-1 00:00:00")); //该循环事件从6.1开始发生
var occurrences = recurringComponent.GetOccurrences(
 Convert.ToDateTime("2013-6-30 23:59:59"),
 //我们虽然要取的是7.1号之后的事件,但是这里不能写成2013-7-1,因为该函数在计算时是>startTime <=endTime
 Convert.ToDateTime("2013-7-31 23:59:59")); //获得循环事件在7月份发生的具体时间 foreach (Occurrence occurrence in occurrences)
{
 DateTime occurrenceTime = occurrence.Period.StartTime.Local;
 Console.WriteLine(occurrenceTime.ToString("yyyy-MM-dd"));
}