iCalendar.org

  * [ Home  ](/Home.html)
  * Specifications ****
    * [ iCalendar (RFC 5545)  ](/RFC-Specifications/iCalendar-RFC-5545/)
    * [ New Properties for iCalendar (RFC 7986)  ](/RFC-Specifications/iCalendar-RFC-7986/)
    * [ iCalendar Venue (Draft)  ](/RFC-Specifications/iCalendar-Venue-Draft/)
    * [ CalDAV Access (RFC 4791)  ](/RFC-Specifications/CalDAV-Access-RFC-4791/)
    * [ CalDAV Scheduling (RFC 6638)  ](/RFC-Specifications/CalDAV-Scheduling-RFC-6638/)
  * [ Validator  ](/validator.html)
  * [ PHP Library  ](/php-library.html)
  * [ RRULE Tool  ](/rrule-tool.html)
  * [ Resources  ](/resources.html)
  * [ News  ](/News/)
  * [ Contact Us  ](/contact-us.html)

[ ![iCalendar.org](https://icalendar.org/images/clipart/icalendar600.png) ](/)

  1. You are here: 
  2. [ Home  ](/Home.html)
  3. [ Specifications  ](/RFC-Specifications/all/)
  4. [ iCalendar (RFC 5545)  ](/RFC-Specifications/iCalendar-RFC-5545/)
  5. 3.8.5.2. Recurrence Date-Times 

Try out our new [ RRULE tool ](/rrule-tool.html) for creating RRULE compatible
strings.

#  3.8.5.2. Recurrence Date-Times

f  Share

URL

##  Property Name

RDATE

##  Purpose

This property defines the list of DATE-TIME values for recurring events, to-
dos, journal entries, or time zone definitions.

##  Value Type

The default value type for this property is DATE-TIME. The value type can be
set to DATE or PERIOD.

##  Property Parameters

IANA, non-standard, value data type, and time zone identifier property
parameters can be specified on this property.

##  Conformance

This property can be specified in recurring [ "VEVENT" ](/iCalendar-
RFC-5545/3-6-1-event-component.html) , [ "VTODO" ](/iCalendar-
RFC-5545/3-6-2-to-do-component.html) , and [ "VJOURNAL" ](/iCalendar-
RFC-5545/3-6-3-journal-component.html) calendar components as well as in the
"STANDARD" and "DAYLIGHT" sub-components of the [ "VTIMEZONE" ](/iCalendar-
RFC-5545/3-6-5-time-zone-component.html) calendar component.

##  Description

This property can appear along with the [ "RRULE" ](/iCalendar-
RFC-5545/3-8-5-3-recurrence-rule.html) property to define an aggregate set of
repeating occurrences. When they both appear in a recurring component, the
recurrence instances are defined by the union of occurrences defined by both
the [ "RDATE" ](/iCalendar-RFC-5545/3-8-5-2-recurrence-date-times.html) and [
"RRULE" ](/iCalendar-RFC-5545/3-8-5-3-recurrence-rule.html) .

The recurrence dates, if specified, are used in computing the recurrence set.
The recurrence set is the complete set of recurrence instances for a calendar
component. The recurrence set is generated by considering the initial [
"DTSTART" ](/iCalendar-RFC-5545/3-8-2-4-date-time-start.html) property along
with the [ "RRULE" ](/iCalendar-RFC-5545/3-8-5-3-recurrence-rule.html) , [
"RDATE" ](/iCalendar-RFC-5545/3-8-5-2-recurrence-date-times.html) , and [
"EXDATE" ](/iCalendar-RFC-5545/3-8-5-1-exception-date-times.html) properties
contained within the recurring component. The [ "DTSTART" ](/iCalendar-
RFC-5545/3-8-2-4-date-time-start.html) property defines the first instance in
the recurrence set. The [ "DTSTART" ](/iCalendar-RFC-5545/3-8-2-4-date-time-
start.html) property value SHOULD match the pattern of the recurrence rule, if
specified. The recurrence set generated with a [ "DTSTART" ](/iCalendar-
RFC-5545/3-8-2-4-date-time-start.html) property value that doesn't match the
pattern of the rule is undefined. The final recurrence set is generated by
gathering all of the start DATE-TIME values generated by any of the specified
[ "RRULE" ](/iCalendar-RFC-5545/3-8-5-3-recurrence-rule.html) and [ "RDATE"
](/iCalendar-RFC-5545/3-8-5-2-recurrence-date-times.html) properties, and then
excluding any start DATE-TIME values specified by [ "EXDATE" ](/iCalendar-
RFC-5545/3-8-5-1-exception-date-times.html) properties. This implies that
start DATE-TIME values specified by [ "EXDATE" ](/iCalendar-
RFC-5545/3-8-5-1-exception-date-times.html) properties take precede