Das vEvent-Datenset ist ein Subset des iCalendar-Formats oder vCalendar-Formats, dem Vorläufer des iCalender-Formats. Der Aufbau folgt den gleichen Regeln wie beim vCard-Format. Auch vCalendar/iCalendar kennen Sie vielleicht aus Microsoft Outlook oder vergleichbaren Anwendungen als Export- und Import-Format für Terminkalendereinträge. Entsprechende Dateien haben die Standardendung .vcs oder .ics.

vEvent-Beispiel 1 (Tagesereignis)

BEGIN:VCALENDAR
VERSION:2.0
BEGIN:VEVENT
DTSTART:20110422
DTEND:20110422
SUMMARY:Karfreitag
END:VEVENT
END:VCALENDAR

vEvent-Beispiel 2 (Termin)

BEGIN:VCALENDAR
VERSION:2.0
BEGIN:VEVENT
DTSTART:20110510T200000+0100
DTEND:20110510T235959+0100
LOCATION:Nirvana Club
SUMMARY:Jahresversammlung 2011 der gescheiterten Existenzen
END:VEVENT
END:VCALENDAR

Erläuterung

Die gewählten Beispiele sind recht einfach und beschreiben nur wenige typische Daten.
Die offizielle Spezifikation und Dokumentation des iCalendar-Formats finden Sie unter:
http://tools.ietf.org/html/rfc2445
RFC (Request for Comment) 2445

Der gesamte Kalendereintrag wird durch BEGIN:VCALENDAR eingeleitet und durch END:VCALENDAR abgeschlossen. Durch BEGIN:VEVENT bzw. END:VEVENT wird das Subset für die Kerndaten markiert. Termine und Tagesereignisse fallen unter die Kategorie VEVENT. Andere Kategorien sind VTODO (für Aufgaben) oder VJOURNAL für Journaleinträge.

Terminanfang und -ende werden durch DTSTART bzw. DTEND definiert. Bei Tagesereignissen wie im ersten der obigen Beispiele wird das Datum ausschließlich in Ziffernform notiert, wobei die ersten vier Ziffern für das Jahr stehen, die nächsten zwei Ziffern für den Monat und die letzten beiden für den Monatstag. Bei Uhrzeit-Terminen wie in unserem zweiten Beispiel folgt hinter der Datumsangabe ein T und dahinter die Uhrzeit als Folge von sechs Ziffern, wobei die ersten beiden Ziffern die Stunde bedeuten, die zweiten beiden die Minuten und die letzten beiden die Sekunden. Bei Uhrzeitangaben ist auch die Angabe der Zeitzone sinnvoll. Deutschland beispielsweise hat die Zeitzone + 1 Stunde gegenüber der UTC-Zeit (Greenwich-Zeit). Notiert wird das in der Form +0100.

Wenn es für einen Termin einen Veranstaltungsort gibt, kann dieser durch LOCATION angegeben werden. Falls mit dem Ereignis auch eine Webadresse verknüpfbar ist, kann zusätzlich ein Feld URL notiert werden. SUMMARY ist das Feld für den Titel des Kalenderereignisses.

Beispiel einer Umsetzung des Tagesereignisses in HTML5-Mikrodatensyntax

Nachfolgender HTML-Ausschnitt setzt das erste der obige VEVENT-Beispiele in Mikrodaten um:

<ul>
<!-- andere Feiertage -->
<li itemscope itemtype="http://microformats.org/profile/hcalendar#vevent">
   <span itemprop="summary">Karfreitag</span>: 
   <time itemprop="dtstart" datetime="2011-04-22">22. April 2011</time>
   <meta itemprop="dtend" content="2011-04-22">
</li>
</ul>

Erläuterung

Das Element, in dem Sie das itemscope-Attribut für das Ereignis oder den Termin notieren, erhält ein itemtype-Attribut, dem die Identifikaitons-URL http://microformats.org/profile/hcalendar#vevent zugewiesen wird. Es handelt sich dabei um das XMDP-Profil für das Mikroformat hCalendar.

Im obigen Beispiel wird eine ungeordnete Liste mit einer Aufzählung von Feiertagen angedeutet. Jeder Listeneintrag, also jedes li-Element, zählt einen Feiertag auf. Deshalb ist das li-Element jeweils der Behälter für die Daten des Feiertags und erhält das itemscope-Attribut sowie das itemtype-Attribut, das den vEvent identifiziert.

Die vEvent-spezifischen Eigenschaften wie summary, dtstart und dtend werden itemprop-Attributen zugewiesen. Da die maschinenlesbaren Zeitangaben von dtstart und dtend für Menschen nicht so gut lesbar sind, werden die Werte dieser Eigenschaften nicht als Elementinhalt notiert, sondern in erkannten Attributen. Ideal geeignet ist das HTML5-Element time, wie es im Beispiel für die dtstart-Eigenschaft verwendet wird. Für die dtend-Eigenschaft kommt dagegen im Beispiel ein <meta>-Tag zum Einsatz. Der Grund ist, dass das Ereignisende zwar semantisch definiert, jedoch im auszugebenden Text nicht sichtbar sein soll.

Beispiel einer Umsetzung des Terminkalendereintrags in HTML5-Mikrodatensyntax

Nachfolgender HTML-Ausschnitt setzt das zweite der obige VEVENT-Beispiele in Mikrodaten um:

<section itemscope itemtype="http://microformats.org/profile/hcalendar#vevent">
<h1 itemprop="summary">Jahresversammlung 2011 der gescheiterten Existenzen</h1>
<p>Wie immer im <span itemprop="location">Nirvana Club</span></p>
<table>
<tr>
<td>Offizieller Beginn:</td>
<td><time itemprop="dtstart" 
     datetime="2011-05-10T20:00:00+01:00">10.05.2011, 20.00 Uhr</time></td>
</tr><tr>
<td>Offizielles Ende:</td>        
<td><time itemprop="dtend" 
     datetime="2011-05-10T23:59:00+01:00">Mitternacht</time></td>
</tr>
</table>
</section>

Erläuterung

In diesem Fall sollen Anfang und Ende der Veranstaltung explizit im Text genannt werden. Deshalb wird die itemprop-Eigenschaft dtend ebenso wie dtstart in ein time-Element gepackt. Die summary-Eigenschaft, die den Termin benennt, ist in diesem Fall durchaus typisch in einer Überschrift untergebracht. Der Veranstaltungsort wird durch itemprop="location" definiert. Der Wert, der dieser Eigenschaft zugeordnet wird, soll zum Redaktionszeitpunkt laut HTML5-Spezifikation nur aus Text bestehen. Eine Aussage zu einer möglichen inneren vCard-Datenstruktur, die im Fall einer vollständigen Adresse des Veranstaltungsorts nahe liegen würde, fehlt.

Liste möglicher itemprop-Eigenschaften

Nachfolgende Tabelle listet die zum Redaktionszeitpunkt in der HTML5-Spezifikation explizit erwähnten vEvent-Eigenschaften für itemprop-Attribute auf.

Korrekturen, Hinweise und Ergänzungen
Bitte scheut euch nicht und meldet, was auf dieser Seite sachlich falsch oder irreführend ist, was ergänzt werden sollte, was fehlt usw. Dazu bitte oben aus dem Menü Seite den Eintrag Diskutieren wählen. Es ist keine Anmeldung erforderlich, um Anmerkungen zu posten. Unpassende Postings, Spam usw. werden allerdings kommentarlos entfernt.