Try out our new RRULE tool for creating RRULE compatible strings.

New Properties for iCalendar (RFC 7986)

Abstract

This document defines a set of new properties for iCalendar data and extends the use of some existing properties to the entire iCalendar object.

Author

C. Daboo, Apple, Inc., October 2016

5.4. LAST-MODIFIED Property

This specification modifies the definition of the "LAST-MODIFIED" property to allow it to be defined in an iCalendar object. The following additions are made to the definition of this property, originally specified in Section 3.8.7.3 of [RFC5545].

Purpose

This property specifies the date and time that the information associated with the calendar was last revised.

Conformance

This property can be specified once in an iCalendar object.

5.5. URL Property

This specification modifies the definition of the "URL" property to allow it to be defined in an iCalendar object. The following additions are made to the definition of this property, originally specified in Section 3.8.4.6 of [RFC5545].

Purpose

This property may be used to convey a location where a more dynamic rendition of the calendar information can be found.

Conformance

This property can be specified once in an iCalendar object.

5.6. CATEGORIES Property

This specification modifies the definition of the "CATEGORIES" property to allow it to be defined in an iCalendar object. The following additions are made to the definition of this property, originally specified in Section 3.8.1.2 of [RFC5545].

Purpose

This property defines the categories for an entire calendar.

Conformance

This property can be specified multiple times in an iCalendar object.

Description

When multiple properties are present, the set of categories that apply to the iCalendar object are the union of all the categories listed in each property value.

5.7. REFRESH-INTERVAL Property

Property Name

REFRESH-INTERVAL

Purpose

This property specifies a suggested minimum interval for polling for changes of the calendar data from the original source of that data.

Value Type

DURATION -- no default

Property Parameters

IANA and non-standard property parameters can be specified on this property.

Conformance

This property can be specified once in an iCalendar object.

Description

This property specifies a positive duration that gives a suggested minimum polling interval for checking for updates to the calendar data. The value of this property SHOULD be used by calendar user agents to limit the polling interval for calendar data updates to the minimum interval specified.

Format Definition

This property is defined by the following notation:

refresh = "REFRESH-INTERVAL" refreshparam ":" dur-value CRLF ;consisting of a positive duration of time.

refreshparam = *(
             ;
             ; The following is REQUIRED,
             ; but MUST NOT occur more than once.
             ;
             (";" "VALUE" "=" "DURATION") /
             ;
             ; The following is OPTIONAL,
             ; and MAY occur more than once.
             ;
             (";" other-param)
             ;
             )

Example

The following is an example of this property

 REFRESH-INTERVAL;VALUE=DURATION:P1W

Page 4 of 9

This document was automatically converted to XHTML using an RFC to HTML converter with the original text document at the Internet Engineering Task Force web site at ietf.org .  The original text document should be referred to if there are any errors or discrepancies found in this document.

Need to test your iCalendar feeds?

The iCalendar Validator provides developers and testers a method to validate their iCalendar feeds, which can take data from either a URL, file or text snippet and compare it against the RFC 5545 specification.  We believe we have one of the best iCalendar validation tools available on the internet. More information about the validator can be found here.