--- title: HTMLTimeElement.dateTime slug: Web/API/HTMLTimeElement/dateTime translation_of: Web/API/HTMLTimeElement/dateTime ---
{{ APIRef("HTML DOM") }}
La propriété HTMLTimeElement.dateTime est une {{domxref("DOMString")}} qui reflète l'attribut HTML {{ htmlattrxref("datetime", "time") }}, contenant une date et une heure interprétable par un ordinateur.

Le format de la chaîne de caractères doit correspondre à l'une des micro-syntaxes HTML suivantes:

Microsyntaxe Description Exemples
Mois AAAA-MM 2011-11, 2013-05

Date

 AAAA-MM-DD 1887-12-01
Date sans l'année MM-DD 11-12
Heure HH:MM
HH:MM:SS
HH:MM:SS.mmm		 23:59
12:15:47
12:15:52.998
Date et heure locale AAAA-MM-DD HH:MM
AAAA-MM-DD HH:MM:SS
AAAA-MM-DD HH:MM:SS.mmm
AAAA-MM-DDTHH:MM
AAAA-MM-DDTHH:MM:SS
AAAA-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
Décalage horaire Z
+HHMM
+HH:MM
-HHMM
-HH:MM		 Z
+0200
+04:30
-0300
-08:00
date et heure globale

N'importe quelle combinaison de date et d'heure locale suivie d'un décalage horaire

 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
Semaine AAAA-WWW 2013-W46

Quatre ou plus chiffres ASCII

 AAAA 2013, 0001
Durée PdDThHmMsS
PdDThHmMs.XS
PdDThHmMs.XXS
PdDThHmMs.XXXS
PThHmMsS
PThHmMs.XS
PThHmMs.XXS
PThHmMs.XXXS
ww dd hh mm ss		 P12DT7H12M13S
P12DT7H12M13.3S
P12DT7H12M13.45S
P12DT7H12M13.455S
PT7H12M13S
PT7H12M13.2S
PT7H12M13.56S
PT7H12M13.999S
7d 5h 24m 13s

Syntaxe

dateTimeString = timeElt.dateTime;
timeElt.dateTime = dateTimeString

Exemple

// Supposons qu'il y ai un élément <time id="t"> dans le HTML

var t = document.getElementById("t");
t.dateTime = "6w 5h 34m 5s";

Spécifications

Spécification Status Commentaire
{{SpecName('HTML WHATWG', "text-level-semantics.html#dom-time-datetime", "HTMLTimeElement")}} {{Spec2('HTML WHATWG')}} Pas de changement depuis {{SpecName("HTML5.1")}}.
{{SpecName('HTML5.1', "text-level-semantics.html#dom-time-datetime", "HTMLTimeElement")}} {{Spec2('HTML5.1')}} Pas de changement depuis {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "text-level-semantics.html#dom-time-datetime", "HTMLTimeElement")}} {{Spec2('HTML5 W3C')}} Définition initiale

Compatibilité des navigateurs

{{Compat("api.HTMLTimeElement.dateTime")}}

Voir aussi