Work with event recurrence rules

You can use the property TimeZoneId with event items that helps to accurately calculate recurring events. The TimeZoneId property is a key string that uniquely identifies a particular time zone. It corresponds to the subkeys located in the folder HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Time Zone.

You can set the TimeZoneId property to UTC, the Sitefinity CMS user interface TimeZone, or any other string representing a valid time zone. You can find a list of valid time zone IDs in the Name of the Time Zone column in the Microsoft time zone index values.

The following sample code demonstrates how to set the TimeZoneId property to the Sitefinity CMS user interface TimeZone: 

• GetRecurrenceExpression(Telerik.Sitefinity.RecurrentRules.For developers: IRecurrenceDescriptor interface descriptor) – Returns a recurrence expression in certain format (iCal by default) calculated basing on the passed For developers: IRecurrenceDescriptor interface object.

  	using System;
  	using System.Collections.Generic;
  	using System.Linq;
  	using System.Text;
  	using System.Threading.Tasks;
  	using Telerik.Sitefinity.RecurrentRules;
  	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.Events
  	{
  	public partial class EventsSnippets
  	{
  	public static string GetRecurrenceExpression()
  	{
  	var startDate = new DateTime(2013, 3, 1);
  	var recursUntil = new DateTime(2013, 3, 3);
  	var duration = TimeSpan.FromMinutes(30);
  	var maxOccurrences = 0;
  	var interval = 1;
  	IRecurrenceDescriptor dailyDescriptor = null;
  	string timeZoneId = "GMT Standard Time";
  	var rrBuilder = new RecurrenceRuleBuilder();
  	var dailyExpression = rrBuilder.CreateDailyRecurrenceExpression(startDate, duration, recursUntil, maxOccurrences, interval, timeZoneId);
  	//if isParsed returns true the iCal daily recurrence expression is parsed
  	var isParsed = rrBuilder.TryParseRecurrenceExpression(dailyExpression, out dailyDescriptor);
  	string dailyExpressionReParsed = rrBuilder.GetRecurrenceExpression(dailyDescriptor);
  	return dailyExpression;
  	}
  	}
  	}

  view raw GetDailyRecExpression.cs hosted with ❤ by GitHub
• TryParseRecurrenceExpression(string recurrenceExpression, out Telerik.Sitefinity.RecurrentRules.For developers: IRecurrenceDescriptor interface descriptor) - Tries to parse a recurrence expression in certain format (iCal by default) to a For developers: IRecurrenceDescriptor interface object
  

  	using System;
  	using System.Collections.Generic;
  	using System.Linq;
  	using System.Text;
  	using System.Threading.Tasks;
  	using Telerik.Sitefinity.RecurrentRules;
  	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.Events
  	{
  	public partial class EventsSnippets
  	{
  	public static bool TryParseRecurrenceExpression()
  	{
  	var startDate = new DateTime(2013, 3, 1);
  	var recursUntil = new DateTime(2013, 3, 3);
  	var duration = TimeSpan.FromMinutes(30);
  	var maxOccurrences = 0;
  	var interval = 1;
  	IRecurrenceDescriptor dailyDescriptor = null;
  	string timeZoneId = "GMT Standard Time";
  	var rrBuilder = new RecurrenceRuleBuilder();
  	var dailyExpression = rrBuilder.CreateDailyRecurrenceExpression(startDate, duration, recursUntil, maxOccurrences, interval, timeZoneId);
  	bool isParsed = rrBuilder.TryParseRecurrenceExpression(dailyExpression, out dailyDescriptor);
  	return isParsed;
  	}
  	}
  	}

  view raw TryParseRecExpression.cs hosted with ❤ by GitHub
• CreateDailyRecurrenceExpression(DateTime start, TimeSpan duration, DateTime recursUntil, int maxOccurrences, int interval) - Creates daily recurrence rule expression in certain format (iCal by default)

  	using System;
  	using System.Collections.Generic;
  	using System.Linq;
  	using System.Text;
  	using System.Threading.Tasks;
  	using Telerik.Sitefinity.RecurrentRules;
  	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.Events
  	{
  	public partial class EventsSnippets
  	{
  	public static string CreateDailyRecurrenceExpression()
  	{
  	var startDate = new DateTime(2013, 3, 1);
  	var recurUntil = new DateTime(2013, 3, 3);
  	var duration = TimeSpan.FromMinutes(30);
  	int interval = 1;
  	int maxOccurrences = 0;
  	string timeZoneId = "FLE Standard Time";
  	var rrBuilder = new RecurrenceRuleBuilder();
  	var dailyExpression = rrBuilder.CreateDailyRecurrenceExpression(startDate, duration, recurUntil, maxOccurrences, interval, timeZoneId);
  	return dailyExpression;
  	}
  	}
  	}

  view raw CreateDailyRecurrenceExpression.cs hosted with ❤ by GitHub
• CreateWeeklyRecurrenceExpression(DateTime start, TimeSpan duration, DateTime recursUntil, int maxOccurrences, int interval, Telerik.Sitefinity.RecurrentRules.RecurrenceDay daysOfWeek) - Creates weekly recurrence rule expression in certain format (iCal by default)

	using System;
	using System.Collections.Generic;
	using System.Linq;
	using System.Text;
	using System.Threading.Tasks;
	using Telerik.Sitefinity.RecurrentRules;
	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.Events
	{
	public partial class EventsSnippets
	{
	public static string CreateWeeklyRecurrenceExpression()
	{
	var startDate = new DateTime(2013, 3, 1);
	var recursUntil = new DateTime(2013, 3, 3);
	var duration = TimeSpan.FromMinutes(30);
	var maxOccurrences = 0;
	var interval = 1;
	string timeZoneId = "GMT Standard Time";
	RecurrenceDay daysOfWeek = RecurrenceDay.WeekDays;
	var rrBuilder = new RecurrenceRuleBuilder();
	var weeklyExpression = rrBuilder.CreateWeeklyRecurrenceExpression(startDate, duration, recursUntil, maxOccurrences, interval, daysOfWeek, timeZoneId);
	return weeklyExpression;
	}
	}
	}

view raw CreateWeeklyRecurrenceExpression.cs hosted with ❤ by GitHub
• CreateWeeklyRecurrenceExpression(DateTime start, TimeSpan duration, DateTime recursUntil, int maxOccurrences, int interval, Telerik.Sitefinity.RecurrentRules.RecurrenceDay daysOfWeek, DayOfWeek firstDayOfWeek) - Creates weekly recurrence rule expression in certain format (iCal by default)

  	using System;
  	using System.Collections.Generic;
  	using System.Linq;
  	using System.Text;
  	using System.Threading.Tasks;
  	using Telerik.Sitefinity.RecurrentRules;
  	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.Events
  	{
  	public partial class EventsSnippets
  	{
  	public static string CreateWeeklyRecurrenceExpressionByFirstDayOfWeek()
  	{
  	var startDate = new DateTime(2013, 3, 1);
  	var recursUntil = new DateTime(2013, 3, 3);
  	var duration = TimeSpan.FromMinutes(30);
  	var maxOccurrences = 0;
  	var interval = 1;
  	string timeZoneId = "GMT Standard Time";
  	var rrBuilder = new RecurrenceRuleBuilder();
  	var weeklyExpression = rrBuilder.CreateWeeklyRecurrenceExpression(startDate, duration, recursUntil, maxOccurrences, interval, RecurrenceDay.Friday, timeZoneId);
  	return weeklyExpression;
  	}
  	}
  	}

  view raw CreateWeeklyRecExprFirstDayOfWeek.cs hosted with ❤ by GitHub
• CreateMonthlyRecurrenceExpression(DateTime start, TimeSpan duration, DateTime recursUntil, int maxOccurrences, int dayOfMonth, int interval) - Creates monthly recurrence rule expression in certain format (iCal by default)

  	using System;
  	using System.Collections.Generic;
  	using System.Linq;
  	using System.Text;
  	using System.Threading.Tasks;
  	using Telerik.Sitefinity.RecurrentRules;
  	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.Events
  	{
  	public partial class EventsSnippets
  	{
  	public static string CreateMonthlyRecurrenceExpression()
  	{
  	var startDate = new DateTime(2013, 3, 1);
  	var recursUntil = new DateTime(2013, 3, 3);
  	var duration = TimeSpan.FromMinutes(30);
  	var maxOccurrences = 0;
  	var interval = 1;
  	int dayOfMonth = 17;
  	string timeZoneId = "GMT Standard Time";
  	var rrBuilder = new RecurrenceRuleBuilder();
  	var monthlyExpression = rrBuilder.CreateMonthlyRecurrenceExpression(startDate, duration, recursUntil, maxOccurrences, dayOfMonth, interval, timeZoneId);
  	return monthlyExpression;
  	}
  	}
  	}

  view raw CreateMonthlyRecExpression.cs hosted with ❤ by GitHub
• CreateMonthlyRecurrenceExpression(DateTime start, TimeSpan duration, DateTime recursUntil, int maxOccurrences, int dayOrdinal, Telerik.Sitefinity.RecurrentRules.RecurrenceDay daysOfWeek, int interval) - Creates monthly recurrence rule expression in certain format (iCal by default)

  	using System;
  	using System.Collections.Generic;
  	using System.Linq;
  	using System.Text;
  	using System.Threading.Tasks;
  	using Telerik.Sitefinity.RecurrentRules;
  	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.Events
  	{
  	public partial class EventsSnippets
  	{
  	public static string CreateMonthlyRecurrenceExpressionByDaysOfWeek()
  	{
  	var startDate = new DateTime(2013, 3, 1);
  	var recursUntil = new DateTime(2013, 3, 3);
  	var duration = TimeSpan.FromMinutes(30);
  	var maxOccurrences = 0;
  	var interval = 1;
  	RecurrenceDay daysOfWeek = RecurrenceDay.WeekDays;
  	int dayOrdinal = 2;
  	string timeZoneId = "GMT Standard Time";
  	var rrBuilder = new RecurrenceRuleBuilder();
  	var monthlyExpression = rrBuilder.CreateMonthlyRecurrenceExpression(startDate, duration, recursUntil, maxOccurrences, dayOrdinal, daysOfWeek, interval, timeZoneId);
  	return monthlyExpression;
  	}
  	}
  	}

  view raw CreateMonthlyRecExpressionDaysOfWeek.cs hosted with ❤ by GitHub
• CreateYearlyRecurrenceExpression(DateTime start, TimeSpan duration, DateTime recursUntil, int maxOccurrences, Telerik.Sitefinity.RecurrentRules.RecurrenceMonth month, int dayOfMonth) - Creates yearly recurrence rule expression in certain format (iCal by default)

  	using System;
  	using System.Collections.Generic;
  	using System.Linq;
  	using System.Text;
  	using System.Threading.Tasks;
  	using Telerik.Sitefinity.RecurrentRules;
  	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.Events
  	{
  	public partial class EventsSnippets
  	{
  	public static string CreateYearlyRecurrenceExpression()
  	{
  	var startDate = new DateTime(2013, 3, 1);
  	var recursUntil = new DateTime(2013, 3, 3);
  	var duration = TimeSpan.FromMinutes(30);
  	var maxOccurrences = 0;
  	int dayOfMonth = 2;
  	RecurrenceMonth months = RecurrenceMonth.August | RecurrenceMonth.September | RecurrenceMonth.October;
  	string timeZoneId = "GMT Standard Time";
  	var rrBuilder = new RecurrenceRuleBuilder();
  	var yearlyExpression = rrBuilder.CreateYearlyRecurrenceExpression(startDate, duration, recursUntil, maxOccurrences, months, dayOfMonth, timeZoneId);
  	return yearlyExpression;
  	}
  	}
  	}

  view raw CreateYearlyRecExpression.cs hosted with ❤ by GitHub
• CreateYearlyRecurrenceExpression(DateTime start, TimeSpan duration, DateTime recursUntil, int maxOccurrences, int dayOrdinal, Telerik.Sitefinity.RecurrentRules.RecurrenceMonth month, Telerik.Sitefinity.RecurrentRules.RecurrenceDay daysOfWeek) - Creates yearly recurrence rule expression in certain format (iCal by default)

  	using System;
  	using System.Collections.Generic;
  	using System.Linq;
  	using System.Text;
  	using System.Threading.Tasks;
  	using Telerik.Sitefinity.RecurrentRules;
  	namespace Telerik.Sitefinity.Documentation.CodeSnippets.DevGuide.SitefinityEssentials.Modules.Events
  	{
  	public partial class EventsSnippets
  	{
  	public static string CreateYearlyRecurrenceExpressionByDaysOfWeek()
  	{
  	var startDate = new DateTime(2013, 3, 1);
  	var recursUntil = new DateTime(2013, 3, 3);
  	var duration = TimeSpan.FromMinutes(30);
  	var maxOccurrences = 0;
  	RecurrenceDay daysOfWeek = RecurrenceDay.WeekDays;
  	int dayOrdinal = 2;
  	RecurrenceMonth months = RecurrenceMonth.August | RecurrenceMonth.September | RecurrenceMonth.October;
  	string timeZoneId = "GMT Standard Time";
  	var builder = new RecurrenceRuleBuilder();
  	var yearlyExpression = builder.CreateYearlyRecurrenceExpression(startDate, duration, recursUntil, maxOccurrences, dayOrdinal, months, daysOfWeek, timeZoneId);
  	return yearlyExpression;
  	}
  	}
  	}

  view raw CreateYearlyRecExprDaysOfWeek.cs hosted with ❤ by GitHub