<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 :
- Une heure sur une horloge de 24 heures.
- Une date précise dans le calendrier grégorien (avec des informations optionnelles sur l'heure et le fuseau horaire).
- Une durée valide (angl.).
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:MMHH:MM:SSHH:MM:SS.mmm
|
23:5912:15:4712:15:52.998
|
| Chaîne de caractères de date et heure locale valide |
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
|
| 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+02001972-07-25 13:43:07+04:301941-03-15 07:06:23.678Z2013-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 |
PdDThHmMsSPdDThHmMs.XSPdDThHmMs.XXSPdDThHmMs.XXXSPThHmMsSPThHmMs.XSPThHmMs.XXSPThHmMs.XXXSww dd hh mm ss
|
P12DT7H12M13SP12DT7H12M13.3SP12DT7H12M13.45SP12DT7H12M13.455SPT7H12M13SPT7H12M13.2SPT7H12M13.56SPT7H12M13.999S7d 5h 24m 13s
|
Exemples
>Exemple simple
HTML
<p>Le concert commence à <time datetime="2018-07-07T20:00:00">20h00</time>.</p>
Résultat
Exemple avec datetime
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.