Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

<time> : l'élément de temps (date)

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨octobre 2017⁩.

L'élément HTML <time> représente une période précise dans le temps. Il peut inclure l'attribut datetime pour traduire les dates dans un format lisible par une machine, permettant d'améliorer les résultats des moteurs de recherche ou d'activer des fonctionnalités personnalisées comme des rappels.

Il peut représenter l'un des éléments suivants :

Exemple interactif

<p>
  The Cure fêtera son 40<sup>e</sup> anniversaire le
  <time datetime="2018-07-07">7 juillet</time> à Hyde Park, Londres.
</p>

<p>
  Le concert commence à <time datetime="20:00">20 h 00</time> et vous pourrez
  profiter du groupe pendant au moins <time datetime="PT2H30M">2 h 30</time>.
</p>
time {
  font-weight: bold;
}

Attributs

Cet élément inclut les attributs universels.

datetime

Cet attribut indique l'heure et/ou la date de l'élément et doit être dans l'un des formats décrits ci-dessous.

Notes d'utilisation

Cet élément est destiné à présenter des dates et des heures dans un format lisible par une machine. Par exemple, cela peut permettre à un agent utilisateur de proposer d'ajouter un évènement à l'agenda d'un·e utilisateur·ice.

Cet élément ne doit pas être utilisé pour des dates antérieures à l'introduction du calendrier grégorien (en raison des complications de calcul pour ces dates).

La valeur datetime (la valeur exploitable informatiquement de l'attribut datetime) est la valeur de l'attribut datetime de l'élément, qui doit être dans le format approprié (voir ci-dessous). Si l'élément ne possède pas d'attribut datetime, il ne doit pas avoir d'éléments descendants, et la valeur datetime est le contenu textuel de l'élément.

Valeurs valides

Description Microsyntaxe Exemples
Chaîne de caractères de mois valide YYYY-MM 2011-11, 2013-05
Chaîne de caractères de date valide YYYY-MM-DD 1887-12-01
Chaîne de caractères de date sans année valide MM-DD 11-12
Chaîne de caractères d'heure valide HH:MM
HH:MM:SS
HH:MM:SS.mmm
23:59
12:15:47
12:15:52.998
Chaîne de caractères de date et heure locale valide 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
Chaîne de caractères de décalage de fuseau horaire valide Z
+HHMM
+HH:MM
-HHMM
-HH:MM
Z
+0200
+04:30
-0300
-08:00
Chaîne de caractères de date et heure globale valide Toute combinaison d'une chaîne de caractères de date et heure locale valide suivie d'une chaîne de caractères de décalage de fuseau horaire valide 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
Chaîne de caractères de semaine valide YYYY-WWW 2013-W46
Quatre chiffres ASCII ou plus YYYY 2013, 0001
Chaîne de caractères de durée valide 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

Exemples

Exemple simple

HTML

html
<p>Le concert commence à <time datetime="2018-07-07T20:00:00">20h00</time>.</p>

Résultat

Exemple avec datetime

HTML

html
<p>Le concert a lieu <time datetime="2001-05-15T19:00">le 15 mai</time>.</p>

Résultat

Résumé technique

Catégories de contenu Contenu de flux, contenu phrasé, contenu tangible.
Contenu autorisé Contenu phrasé.
Omission de balises Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires.
Parents autorisés Tout élément qui accepte du contenu phrasé.
Rôle ARIA implicite time
Rôles ARIA autorisés Tous les rôles sont autorisés
Interface DOM HTMLTimeElement

Spécifications

Specification
HTML
# the-time-element

Compatibilité des navigateurs

Voir aussi

  • L'élément <data> qui permet de représenter des valeurs différentes.