<time>

Résumé

L'élément HTML<time> représente soit une heure sur une horloge  fonctionnant sur 24 heures ou une date précise du calendrier grégorien (des informations facultatives sur l'heure ou le fuseau-horaire). Cet élément est conçu pour permettre l'utilisation d'informations temporelles dans un format interprétable par un ordinateur. Cela peut par exemple être utile aux différents agents installés sur le poste de l'utilisateur pour gérer un emploi du temps.

• Catégories de contenu Contenu de flux, contenu phrasé.
• Contenu autorisé contenu phrasé ne contenant pas d'éléments time
• Omission de balises Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires
• Élément parents autorisés Tout élément acceptant du contenu phrasé.
• Interface DOM HTMLTimeElement

Attributs

Comme tous les éléments HTML, cet élément possède les attributs globaux.

datetime

Cet attribut indique l'heure et la date de l'élément et doit être une date valide, avec une chaîne de caractère optionnelle pour l'heure. Si la valeur ne peut pas être comprise comme telle, l'élément n'aura pas d'information temporelle associée.

pubdate

(Cette fonctionnalité est toujours à l'état de discussions entre le  WHATWG et le groupe de travail du W3C sur HTML5.) Cet attribut booléen précise si la date et l'heure données par un élément correspondent à la date de publication d'un document. Le document en question est soit l'élément article ancêtre le plus proche ou le document en entier (s'il n'y a pas d'ancêtre article). Si cet attribut vaut true, l'élément time doit avoir une date correspondante. De plus, chaque élément time précisant une date de publication doit être le seul élément time pour un document donné.

Exemples

Exemple simple

<p>Le concert commence à <time>20:00</time>.</p>

Le fragment de code HTML ci-dessus donnera le résultat suivant :

Le concert commence à 20:00.

Exemple avec pubdate

<article>
  <p>L'article a été créé le <time pubdate>2011-01-28</time>.</p>
</article>

Le fragment de code HTML ci-dessus donnera le résultat suivant :

L'article a été créé le 2011-01-28.

Exemple avec datetime

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

Le fragment de code HTML ci-dessus donnera le résultat suivant :

Le concert a eu lieu le 15 mai.

Spécifications

Compatibilité des navigateurs