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

CKTIS / HTML

time — dates et heures lisibles par machine

L’élément `time` balise une date, une heure ou une durée. Son attribut `datetime` associe un texte facile à lire pour les personnes à une représentation non ambiguë lisible par machine.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<time datetime="YYYY-MM-DD">human-readable date</time>

time donne à son contenu un sens lié à une date ou à une heure. L’attribut facultatif datetime fournit son équivalent lisible par machine. En son absence, le texte lui-même doit respecter un format autorisé et l’élément ne doit avoir aucun élément descendant. Les deux balises sont obligatoires.

Les représentations autorisées comprennent un mois 2026-11, une date 2026-11-18, une date sans année 11-18, une heure 14:30, une date et heure locales 2026-11-18T14:30, un décalage +01:00, une date et heure globales 2026-11-18T14:30Z, une semaine 2026-W47, une année 2026 et une durée PT30M. Une année doit comporter au moins quatre chiffres ASCII et ne peut pas être zéro. Les dates doivent être valides dans le calendrier.

Une date et heure locales ne désignent pas un instant global unique ; une représentation globale comprend Z ou un décalage par rapport à UTC. Un décalage n’est pas le nom d’un fuseau horaire géographique.

Dans l’exemple, le texte et datetime décrivent la même date. La propriété DOM dateTime reflète l’attribut datetime ; la sortie attendue dans la console est 2026-11-18.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Time example</title>
<p><time id="event" datetime="2026-11-18">18 November 2026</time></p>
<script>
  const eventTime = document.getElementById('event');
  console.log(eventTime.dateTime);
</script>
</html>

Résultat

2026-11-18

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources