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=V0email@example.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:V0firstname.lastname@example.org 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.