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

2. An Example

To facilitate understanding the detailed descriptions below, here is an example iCalendar file including the proposed venue component. This example is for a Joe Bloggs concert occuring at The Venue in San Diego, CA.

BEGIN:VCALENDAR
PRODID:-//Eventful//Eventful 2.0//EN
VERSION:2.0
BEGIN:VTIMEZONE
TZID:US/Pacific
LAST-MODIFIED:20060110T171418Z
BEGIN:STANDARD
DTSTART:20051030T080000
TZOFFSETTO:-0700
TZOFFSETFROM:+0000
TZNAME:MST
END:STANDARD
BEGIN:DAYLIGHT
DTSTART:20060402T020000
TZOFFSETTO:-0600
TZOFFSETFROM:-0700
TZNAME:MDT
END:DAYLIGHT
END:VTIMEZONE
BEGIN:VEVENT
LOCATION;VVENUE=V0-001-000153774-0@eventful.com:The Venu
  e\n1055 Fifth Avenue\nSan Diego, CA  92101
DTSTAMP:20060110T171344Z
DTSTART;TZID=US/Pacific:20060717T200000
SUMMARY:Joe Bloggs in concert
DTEND;TZID=US/Pacific:20060717T2300000
DESCRIPTION:Joe Bloggs plays everything from the old
  Simon & Garfunkle stuff to his latest album. Not to be
  missed!
END:VEVENT
BEGIN:VVENUE
UID:V0-001-000153774-0@eventful.com
NAME:The Venue
DESCRIPTION: The Venues is a home for live music and
  southern-inspired cuisine in an environment celebrating
  the Afric an American cultural contributions of blues
  music and folk art.
STREET-ADDRESS:1055 Fifth Avenue\nSuite 4
EXTENDED-ADDRESS:Stage 2
LOCALITY:San Diego
REGION;ABBREV=CA:California
COUNTRY;ABBREV=US;ABBREV=USA:United States
POSTAL-CODE:92101
TZID=US/Pacific
GEO:32.716220;-117.160156
URL;TYPE=Map:http://maps.google.com/maps?q=1055%20Fifth
  %20Avenue%2C%20San%20Diego%2C%20California%20&hl=en
URL;TYPE=Eventful Listing:http://eventful.com/venues/
  V0-001-000153774-0
URL;TYPE=Official Site:http://www.example.com/venues/clubvenues
  /sandiego/
TEL;TYPE=Box Office:619.299.2583
CATEGORIES:music concert
END:VVENUE
END:VCALENDAR

The "VVENUE" component works similarly to "VTIMEZONE". It is referenced by parameter from the "LOCATION" property of a "VEVENT".

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.