datetime

Auftreten

optional/vorgeschrieben (je nach Kontext), einmal

Attribute

Beschreibung

<datetime> bezeichnet allgemein eine Datums-/Zeitangabe nach den Konventionen der International Organization for Standardization (ISO), ISO 8601 (siehe hierzu z.B. auch http://de.wikipedia.org/wiki/ISO_8601 und http://en.wikipedia.org/wiki/ISO_8601). Dabei wird zunächst die vierstellige Jahreszahl, dann die zweistellige Monatszahl (gegebenenfalls mit führender Null) und dann die zweistellige Tageszahl (gegebenenfalls mit führender Null) angegeben. Jahres-, Monats- und Tageszahl können durch ein Minuszeichen "-" zur besseren Lesbarkeit voneinander getrennt werden. Danach folgt gegebenenfalls — getrennt entweder durch ein Leerzeichen oder durch den Großbuchstaben "T" (für englisch "Time") — die Uhrzeit. Stunden, Minuten und Sekunden werden jeweils zweistellig (gegebenenfalls mit führender Null) angegeben. Hierbei können Stunden, Minuten und Sekunden wiederum zur besseren Lesbarkeit durch einen Doppelpunkt ":" voneinander getrennt werden. Abschließend kann der Uhrzeitangabe der Großbuchstabe "Z" (von "Zulu-Time") für die koordinierte Weltzeit (UTC) angehängt werden oder — diese genauer spezifizierend — "+" oder "-" gefolgt von der zweistelligen Anzahl Stunden und gegebenenfalls den zweistelligen Minuten (gegebenenfalls getrennt durch einen Doppelpunkt zur besseren menschlichen Lesbarkeit).

Nicht in jedem Fall sind Datum und Uhrzeit bekannt. In solchen Fällen werden die "letzten" Angaben "von hinten" weggelassen. Wird nur die Uhrzeit angegeben, muß dieser ein "T" vorangestellt werden.

Beispiele:

  • Februar 1985 -> 1985-02 oder 198502

  • 5. Januar 1997 -> 1997-01-05 oder 19970105

  • 25. Oktober 2008, 16:05 Uhr UTC -> 2008-10-25T16:05 oder 2008-10-25T16:05Z oder 2008-10-25T16:05+00:00 oder 2008-10-25 16:05 oder 20081025T1605 oder 20081025T1605+0000

  • 9:47 Uhr -> T09:47 oder T0947 (das "T" muß hierbei angegeben werden — im Format T0947 würde es sich ohne "T" um die Jahreszahl 947 handeln)

<datetime> erlaubt ebenfalls die Angabe einer Zeitdauer. Dazu wird dem Ausdruck ein großes "P" (von englisch "period", Dauer) vorangestellt. Das Format lautet dann PnYnMnDTnHnMnS, wobei "n" jeweils für die Anzahl des folgenden Spezifizierers steht und "Y" für Jahr, "M" für Monat, "D" für Tag, "T" für den Beginn der folgenden Uhrzeit, "H" für Stunden, "M" für Minuten und "S" für Sekunden. Ebenso können auch die Anzahl Wochen angegeben werden, das Format lautet dann PnW. Führende Nullen sind hierbei nicht erforderlich. Datums- und Uhrzeitelemente, deren Wert Null ist, können entfallen. Der kleinste aufgeführte Wert kann als Dezimalzahl angegeben werden.

Beispiele:

  • 3 Jahre, 8 Monate, 20 Tage, 7 Stunden, 45 Minuten, 18 Sekunden -> P3Y8M20DT7H45M18S

  • 9 Jahre -> P9Y

  • 3 Monate -> P3M, aber 3 Minuten -> PT3M

  • ein halbes Jahr -> P6M oder auch P0.5Y

  • 36 Stunden -> PT36H oder P1DT12H sind beide möglich

Eine Zeitdauer kann in drei verschiedenen Formen angegeben werden. Als Start- und Enddatum, als Startdatum mit anschließender Dauer oder als Dauer mit abschließendem Enddatum. Als Trennzeichen fungiert jeweils ein Schrägstrich "/". In den folgenden Beispielen sei das Startdatum der 1. Mai 2000 und das Enddatum der 1. Juli 2000 (Dauer zwei Monate ;-) ).

  • Angabe als Start- und Enddatum -> 2000-05-01/2000-07-01

  • Angabe als Startdatum mit Dauer -> 2000-05-01/P2M

  • Angabe als Dauer mit Enddatum -> P2M/2000-07-01

<datetime> ist immer dann vorgeschrieben, wenn es das einzige Kind-Element seines Eltern-Elementes ist. Dies ist der Fall bei <dateofflight>, <dateoftrip>, <issuedate>, <sunk> und <validdate>. Außerdem muß es innerhalb <divecomputerdump> angegeben werden (obwohl es dort ein zweites — ebenfalls vorgeschriebenes — Element <dcdump> gibt). Bei allen anderen Eltern-Elementen kann <datetime> angegeben werden, muß aber nicht.

Eltern-Elemente

<dateofflight>, <dateoftrip>, <dive>, <divecomputerdump>, <examination>, <generator>, <imagedata>, <issuedate>, <purchase>, <sunk>, <validdate>

Kind-Elemente

Siehe Auch

Beispiele

(siehe z.B. auch <examination> oder <imagedata>)

<repetitiongroup>
    <dive>
        ...
        <!-- Datum 6. April 1999 (ein Dienstag), 10.24 Uhr -->
        <datetime>1999-04-06T10:24</datetime>
        <!-- hier weitere Anweisungen -->
        ...
    </dive>
    <!-- hier können weitere Tauchgänge folgen -->
    ...
</repetitiongroup>