Events.Item.AddRecurrenceRule
-----------------------------

Adds a recurrence rule.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Events](component_Events.md) | [6.2](newinversion62.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "Events.Item.AddRecurrenceRule"; EKCalendarItem; EKRecurrenceRule ) 

**MBS**( **"Events.Item.AddRecurrenceRule";** /\* Adds a recurrence rule. \*/  
**$EKCalendarItem**; /\* The reference to the calendar item: an event or reminder.e.g. $item \*/   
**$EKRecurrenceRule**) /\* The reference to the recurrence rule.e.g. $RecurrenceRule \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| EKCalendarItem | The reference to the calendar item: an event or reminder. | $item |
| EKRecurrenceRule | The reference to the recurrence rule. | $RecurrenceRule |

### Result

Returns OK or error.

### Description

Adds a recurrence rule.  
### Examples

Create a recurrence rule with end date for a yearly event:

 Set Variable \[ $rule ; Value: MBS ( "[Events.RecurrenceRule.NewWithFrequency](EventsRecurrenceRuleNewWithFrequency.md)"; "Yearly";"1" ) \]   
Set Variable \[ $end ; Value: MBS ( "[Events.RecurrenceEnd.NewWithEndDate](EventsRecurrenceEndNewWithEndDate.md)"; Date ( 12 ; 30 ; 2025 ) ) \]   
Set Variable \[ $r ; Value: MBS ( "[Events.RecurrenceRule.SetRecurrenceEnd](EventsRecurrenceRuleSetRecurrenceEnd.md)"; $rule ; $end ) \]   
Set Variable \[ $r ; Value: MBS ( "Events.Item.AddRecurrenceRule"; $item ; $rule ) \]  
### See also

- [Events.Item.HasRecurrenceRules](EventsItemHasRecurrenceRules.md)
- [Events.Item.RecurrenceRules](EventsItemRecurrenceRules.md)
- [Events.Item.RemoveRecurrenceRule](EventsItemRemoveRecurrenceRule.md)
- [Events.RecurrenceEnd.NewWithEndDate](EventsRecurrenceEndNewWithEndDate.md)
- [Events.RecurrenceRule.NewWithFrequency](EventsRecurrenceRuleNewWithFrequency.md)
- [Events.RecurrenceRule.SetRecurrenceEnd](EventsRecurrenceRuleSetRecurrenceEnd.md)

This function checks for a license.

Created 10th March 2016 , last changed 1st November 2020

  
[Events.Item.AddAlarm](EventsItemAddAlarm.md) - [Events.Item.Alarms](EventsItemAlarms.md)

[HTML Version](EventsItemAddRecurrenceRule.shtml)