The hCalendar microformat

The hCalendar microformat represents an appointment or other event on a calendar.

The class name is vevent. There are two required properties: summary and dtstart.

Properties

The value of each property is a string unless anything else is specified. If a property is not marked as required, the value might be undefined.

Tip: The function Microformats.dateFromISO8601 takes a normalized ISO 8601 date as its first parameter and returns the corresponding date.
Property Description
category Zero or more categories with which the event is associated. If a category is also a tag microformat, its "tag" property is used. The value is either undefined or a non-empty array where each element is a string.
class The classification of the event. This is one of public, private, or confidential.
description An description of the event, using HTML. The value is some kind of object.
dtstart The date and time at which the event begins, normalized to an ISO8601 date. Required.
dtend The date and time at which the event ends, normalized to an ISO8601 date.
dtstamp The date and time at which the calendar entry was created, normalized to an ISO8601 date.
duration The length of the event. This can be things such as "1w" for one week, or "1h" for one hour. See the description in RFC 2445 for details.
geo A physical location associated with the event. The value is a geo microformat where none of the properties are required.
location A location at which the event is to take place. The value is either a string or an hCard microformat where none of the properties are required.
status The status of the event. This can be one of tentative, confirmed, cancelled.
summary A brief description of the event. Required.
transp Specifies whether or not the event should be ignored when searching for openings in the user's calendar. If this value is transparent, the time occupied by this event is considered to be free when looking for openings in the calendar. If the value is opaque, the time occupied is considered unavailable for assignment.
uid A unique ID for the event.
url A URL associated with the event.
last-modified The date and time at which the event was last modified, normalized to an ISO8601 date.
rrule Specifies recurrence rules for the event. See RFC 2445 for details. I am not sure what the type of the value is. Reading may throw an exception.

 

See also

Document Tags and Contributors

Contributors to this page: Dikrib, Sheppy, Mgjbot, Kohei
Last updated by: Sheppy,