The hCalendar microformat

  • Revision slug: The_hCalendar_microformat
  • Revision title: The hCalendar microformat
  • Revision id: 133524
  • Created:
  • Creator: Dikrib
  • Is current revision? No
  • Comment 37 words added, 27 words removed

Revision Content

{{ Fx_minversion_header("3") }} 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 ISO8601 date as it's 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

{{ languages( { "es": "es/El_Microformato_hCalendar", "ja": "ja/The_hCalendar_microformat" } ) }}

Revision Source

<p>{{ Fx_minversion_header("3") }} The <code>hCalendar</code> microformat represents an appointment or other event on a calendar.</p>
<p>The class name is <code>vevent</code>. There are two required properties: <code>summary</code> and <code>dtstart</code>.</p>
<h2 name="Properties">Properties</h2>
<p>The value of each property is a <a class="internal" href="/en/Core_JavaScript_1.5_Reference/Global_Objects/String" title="en/Core JavaScript 1.5 Reference/Global Objects/String">string</a> unless anything else is specified. If a property is <strong>not</strong> marked as <strong>required</strong>, the value might be <a class="internal" href="/en/Core_JavaScript_1.5_Reference/Global_Properties/undefined" title="en/Core JavaScript 1.5 Reference/Global Properties/undefined">undefined</a>. Tip: The function Microformats.dateFromISO8601 takes a normalized ISO8601 date as it's first parameter and returns the corresponding <a class="internal" href="/en/Core_JavaScript_1.5_Reference/Global_Objects/Date" title="en/Core JavaScript 1.5 Reference/Global Objects/Date">date</a>.</p>
<table class="standard-table"> <tbody> <tr> <th>Property</th> <th>Description</th> </tr> <tr> <td><code>category</code></td> <td>Zero or more categories with which the event is associated. If a category is also a <code><a href="/en/The_tag_microformat" title="en/The_tag_microformat">tag</a></code> microformat, its "tag" property is used. The value is either <a class="internal" href="/en/Core_JavaScript_1.5_Reference/Global_Properties/undefined" title="en/Core JavaScript 1.5 Reference/Global Properties/undefined">undefined</a> or a non-empty <a class="internal" href="/en/Core_JavaScript_1.5_Reference/Global_Objects/Array" title="en/Core JavaScript 1.5 Reference/Global Objects/Array">array</a> where each element is a <a class="internal" href="/en/Core_JavaScript_1.5_Reference/Global_Objects/String" title="en/Core JavaScript 1.5 Reference/Global Objects/String">string</a>.</td> </tr> <tr> <td><code>class</code></td> <td>The classification of the event. This is one of <code>public</code>, <code>private</code>, or <code>confidential</code>.</td> </tr> <tr> <td><code>description</code></td> <td>An description of the event, using HTML. The value is some kind of object.</td> </tr> <tr> <td><code>dtstart</code></td> <td>The date and time at which the event begins, normalized to an ISO8601 date. <strong>Required.</strong></td> </tr> <tr> <td><code>dtend</code></td> <td>The date and time at which the event ends, normalized to an ISO8601 date.</td> </tr> <tr> <td><code>dtstamp</code></td> <td>The date and time at which the calendar entry was created, normalized to an ISO8601 date.</td> </tr> <tr> <td><code>duration</code></td> <td>The length of the event. This can be things such as "1w" for one week, or "1h" for one hour. See the description in <a class="external" href="http://tools.ietf.org/html/rfc2445" title="http://tools.ietf.org/html/rfc2445">RFC 2445</a> for details.</td> </tr> <tr> <td><code>geo</code></td> <td>A physical location associated with the event. The value is a <code><a href="/en/The_geo_microformat" title="en/The_geo_microformat">geo</a></code> microformat where none of the properties are required.</td> </tr> <tr> <td><code>location</code></td> <td>A location at which the event is to take place. The value is either a <a class="internal" href="/en/Core_JavaScript_1.5_Reference/Global_Objects/String" title="en/Core JavaScript 1.5 Reference/Global Objects/String">string</a> or an <code><a href="/en/The_hCard_microformat" title="en/The_hCard_microformat">hCard</a></code> microformat where none of the properties are required.</td> </tr> <tr> <td><code>status</code></td> <td>The status of the event. This can be one of <code>tentative</code>, <code>confirmed</code>, <code>cancelled</code>.</td> </tr> <tr> <td><code>summary</code></td> <td>A brief description of the event. <strong>Required.</strong></td> </tr> <tr> <td><code>transp</code></td> <td>Specifies whether or not the event should be ignored when searching for openings in the user's calendar. If this value is <code>transparent</code>, the time occupied by this event is considered to be free when looking for openings in the calendar. If the value is <code>opaque</code>, the time occupied is considered unavailable for assignment.</td> </tr> <tr> <td><code>uid</code></td> <td>A unique ID for the event.</td> </tr> <tr> <td><code>url</code></td> <td>A URL associated with the event.</td> </tr> <tr> <td><code>last-modified</code></td> <td>The date and time at which the event was last modified, normalized to an ISO8601 date.</td> </tr> <tr> <td><code>rrule</code></td> <td>Specifies recurrence rules for the event. See <a class="external" href="http://tools.ietf.org/html/rfc2445" title="http://tools.ietf.org/html/rfc2445">RFC 2445</a> for details. I am not sure what the type of the value is. Reading may throw an exception.</td> </tr> </tbody>
</table>
<p> </p><h2 name="See_also">See also</h2>
<ul> <li><a class="external" href="http://tools.ietf.org/html/rfc2445" title="http://tools.ietf.org/html/rfc2445">RFC 2445</a> - iCalendar</li> <li><a href="/en/The_hCard_microformat" title="en/The_hCard_microformat">The hCard microformat</a></li> <li><a href="/en/The_geo_microformat" title="en/The_geo_microformat">The geo microformat</a></li> <li><a href="/en/Using_microformats" title="en/Using_microformats">Using microformats</a></li> <li><a href="/en/Parsing_microformats_in_JavaScript" title="en/Parsing_microformats_in_JavaScript">Parsing microformats in JavaScript</a></li> <li><a href="/en/Describing_microformats_in_JavaScript" title="en/Describing_microformats_in_JavaScript">Describing microformats in JavaScript</a></li>
</ul> <p>{{ languages( { "es": "es/El_Microformato_hCalendar", "ja": "ja/The_hCalendar_microformat" } ) }}</p>
Revert to this revision