<time>: Das (Datum-) Zeit-Element
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.
Das <time>
HTML-Element repräsentiert einen bestimmten Zeitraum. Es kann das datetime
-Attribut enthalten, um Daten in ein maschinenlesbares Format zu übersetzen, was zu besseren Suchmaschinenergebnissen oder benutzerdefinierten Funktionen wie Erinnerungen führt.
Es kann Folgendes darstellen:
- Eine Uhrzeit im 24-Stunden-Format.
- Ein genaues Datum im Gregorianischen Kalender (mit optionalen Zeit- und Zeitzoneninformationen).
- Eine gültige Zeitdauer.
Probieren Sie es aus
Attribute
Wie alle anderen HTML-Elemente unterstützt dieses Element die globalen Attribute.
datetime
-
Dieses Attribut gibt die Zeit und/oder das Datum des Elements an und muss in einem der unten beschriebenen Formate vorliegen.
Verwendungshinweise
Dieses Element dient der Darstellung von Daten und Zeiten in einem maschinenlesbaren Format. Zum Beispiel kann dies einem Benutzeragenten helfen, dem Benutzer anzubieten, ein Ereignis in dessen Kalender hinzuzufügen.
Dieses Element sollte nicht für Daten verwendet werden, die vor der Einführung des Gregorianischen Kalenders liegen (aufgrund von Komplikationen bei der Berechnung dieser Daten).
Der datetime-Wert (der maschinenlesbare Wert von datetime) ist der Wert des datetime
-Attributs des Elements, das im richtigen Format vorliegen muss (siehe unten). Wenn das Element kein datetime
-Attribut hat, darf es keine Nachkommenelemente haben, und der datetime-Wert ist der Kindtextinhalt des Elements.
Gültige datetime-Werte
Beschreibung | Mikrosyntax | Beispiele |
---|---|---|
Gültiger Monatsstring | YYYY-MM |
2011-11 , 2013-05 |
Gültiger Datumsstring | YYYY-MM-DD |
1887-12-01 |
Gültiger jahrfreier Datumsstring | MM-DD |
11-12 |
Gültiger Zeitstring |
HH:MM HH:MM:SS HH:MM:SS.mmm
|
23:59 12:15:47 12:15:52.998
|
Gültiger lokaler Datums- und Zeitstring |
YYYY-MM-DD HH:MM YYYY-MM-DD HH:MM:SS YYYY-MM-DD HH:MM:SS.mmm YYYY-MM-DDTHH:MM YYYY-MM-DDTHH:MM:SS YYYY-MM-DDTHH:MM:SS.mmm
|
2013-12-25 11:12 1972-07-25 13:43:07 1941-03-15 07:06:23.678 2013-12-25T11:12 1972-07-25T13:43:07 1941-03-15T07:06:23.678
|
Gültige Zeitzonen-Offset-String |
Z +HHMM +HH:MM -HHMM -HH:MM
|
Z +0200 +04:30 -0300 -08:00
|
Gültiger globaler Datums- und Zeitstring | Jede Kombination eines gültigen lokalen Datums- und Zeitstrings gefolgt von einem gültigen Zeitzonen-Offset-String |
2013-12-25 11:12+0200 1972-07-25 13:43:07+04:30 1941-03-15 07:06:23.678Z 2013-12-25T11:12-08:00
|
Gültiger Wochenstring | YYYY-WWW |
2013-W46 |
Vier oder mehr ASCII-Ziffern | YYYY |
2013 , 0001 |
Gültiger Dauerstring |
PdDThHmMsS PdDThHmMs.XS |
P12DT7H12M13S P12DT7H12M13.3S P12DT7H12M13.45S P12DT7H12M13.455S PT7H12M13S PT7H12M13.2S PT7H12M13.56S PT7H12M13.999S 7d 5h 24m 13s
|
Beispiele
Einfaches Beispiel
HTML
<p>The concert starts at <time datetime="2018-07-07T20:00:00">20:00</time>.</p>
Ergebnis
datetime
-Beispiel
HTML
<p>
The concert took place on <time datetime="2001-05-15T19:00">May 15</time>.
</p>
Ergebnis
Technische Zusammenfassung
Inhaltskategorien | Fließender Inhalt, phrasierender Inhalt, handhabbarer Inhalt. |
---|---|
Erlaubter Inhalt | Phrasierender Inhalt. |
Tag-Auslassung | Keine, sowohl das Start- als auch das End-Tag sind erforderlich. |
Erlaubte Eltern | Jedes Element, das phrasierenden Inhalt akzeptiert. |
Implizite ARIA-Rolle |
time
|
Erlaubte ARIA-Rollen | Jede |
DOM-Schnittstelle | [`HTMLTimeElement`](/de/docs/Web/API/HTMLTimeElement) |
Spezifikationen
Specification |
---|
HTML # the-time-element |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Das
<data>
-Element, das andere Arten von Werten signalisiert.