Attributen
Zoals alle andere HTML-elementen ondersteunt dit element de globale attributen.
datetime | Dit attribuut geeft de tijd en/of datum van het element aan en moet in een van de hieronder beschreven formaten zijn. |
|---|
Gebruiksnotities
Dit element is bedoeld om datums en tijden in een machineleesbaar formaat weer te geven. Dit kan bijvoorbeeld een user agent helpen om aan te bieden een gebeurtenis toe te voegen aan de agenda van een gebruiker.
Dit element mag niet worden gebruikt voor datums van vóór de invoering van de Gregoriaanse kalender (vanwege complicaties bij het berekenen van die datums).
De datetime-waarde (de machineleesbare waarde van de datum-tijd) is de waarde van het datetime-attribuut van het element, dat in het juiste formaat moet zijn (zie hieronder). Als het element geen datetime-attribuut heeft, mag het geen elementen als afstammelingen hebben, en is de datetime-waarde de tekstinhoud van het kind-element.
Geldige datetime-waarden
| Beschrijving | Microsyntax | Voorbeelden |
|---|---|---|
| Geldige maandstring | YYYY-MM |
2011-11, 2013-05 |
| Geldige datumstring | YYYY-MM-DD |
1887-12-01 |
| Geldige jaarloze datumstring | MM-DD |
11-12 |
| Geldige tijdstring |
HH:MMHH:MM:SSHH:MM:SS.mmm
|
23:5912:15:4712:15:52.998
|
| Geldige lokale datum- en tijdstring |
YYYY-MM-DD HH:MMYYYY-MM-DD HH:MM:SSYYYY-MM-DD HH:MM:SS.mmmYYYY-MM-DDTHH:MMYYYY-MM-DDTHH:MM:SSYYYY-MM-DDTHH:MM:SS.mmm
|
2013-12-25 11:121972-07-25 13:43:071941-03-15 07:06:23.6782013-12-25T11:121972-07-25T13:43:071941-03-15T07:06:23.678
|
| Geldige tijdzone-offsetstring |
Z+HHMM+HH:MM-HHMM-HH:MM
|
Z+0200+04:30-0300-08:00
|
| Geldige globale datum- en tijdstring | Elke combinatie van een geldige lokale datum- en tijdstring gevolgd door een geldige tijdzone-offsetstring |
2013-12-25 11:12+02001972-07-25 13:43:07+04:301941-03-15 07:06:23.678Z2013-12-25T11:12-08:00
|
| Geldige weekstring | YYYY-WWW |
2013-W46 |
| Vier of meer ASCII-cijfers | YYYY |
2013, 0001 |
| Geldige tijdsduurstring |
PdDThHmMsSPdDThHmMs.XSPdDThHmMs.XXSPdDThHmMs.XXXSPThHmMsSPThHmMs.XSPThHmMs.XXSPThHmMs.XXXSww dd hh mm ss
|
P12DT7H12M13SP12DT7H12M13.3SP12DT7H12M13.45SP12DT7H12M13.455SPT7H12M13SPT7H12M13.2SPT7H12M13.56SPT7H12M13.999S7d 5h 24m 13s
|
Voorbeelden
Basisvoorbeeld
HTML
<p>The concert starts at <time datetime="2018-07-07T20:00:00">20:00</time>.</p>Resultaat
datetime-voorbeeld
HTML
<p>
The concert took place on <time datetime="2001-05-15T19:00">May 15</time>.
</p>Resultaat
Technische samenvatting
| Content categories | Flow content, phrasing content, palpable content. |
|---|---|
| Toegestane inhoud | Phrasing content. |
| Weglaten van tags | Geen, zowel de begin- als eindtag zijn verplicht. |
| Toegestane bovenliggende elementen | Elk element dat phrasing content accepteert. |
| Impliciete ARIA-rol |
time
|
| Toegestane ARIA-rollen | Alle |
| DOM-interface | HTMLTimeElement |