Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

datetime : une information temporelle lisible par la machine

Séparez le libellé humain d’une date, heure ou modification précise.

Version : HTML Living Standard

Syntaxe

<time datetime="2026-11-18T10:00:00+01:00">Morning meeting</time>

Sur time, datetime donne une représentation machine du contenu visible. Les formats permis comprennent dates, heures, mois, semaines, durées et certaines dates avec heure ; ce ne sont pas tous des horodatages JavaScript complets. Sur les éléments d’insertion et de suppression, il décrit plutôt la date du changement, éventuellement avec une heure globale.

Respectez la syntaxe de l’élément. Une date-heure locale sans décalage ne désigne pas un instant mondial unique. Pour un instant partagé, précisez un décalage ou UTC ; un décalage n’est pas une règle de fuseau géographique. L’attribut ne traduit ni ne remplace automatiquement le libellé visible.

L’exemple compare deux dates-heures complètes avec des décalages différents désignant le même instant. JavaScript confirme leur égalité tandis que le libellé reste inchangé. Cela ne signifie pas que toute valeur temporelle HTML valide soit analysable de la même manière.

Exemples

<!doctype html><meta charset="utf-8">
<time id="local" datetime="2026-11-18T10:00:00+01:00">Morning meeting</time>
<time id="utc" datetime="2026-11-18T09:00:00Z">UTC reference</time><output id="result"></output>
<script>
const local = document.querySelector('#local'), utc = document.querySelector('#utc');
const sameInstant = Date.parse(local.dateTime) === Date.parse(utc.dateTime);
document.querySelector('#result').textContent = 'sameInstant=' + sameInstant + '; visible=' + local.textContent;
</script>

Résultat

sameInstant=true; visible=Morning meeting

La comparaison utilise des dates-heures complètes avec décalages explicites, pas des heures locales ambiguës.

Sources