Utiliser les formats de date et d'heure en HTML - HTML | MDN

HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
Learn web development
Get to know MDN better
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
Certains éléments HTML manipulent des valeurs temporelles pour des dates ou des heures. Les formats utilisés pour les chaînes de caractères qui définissent ces valeurs sont décrits dans cet article.
Les éléments qui utilisent ces données sont notamment les éléments <input> qui permettent de choisir une date, une heure ou les deux, les éléments <ins> et <del> dont l'attribut datetime définit la date ou la date et l'heure à laquelle l'ajout ou la suppression de contenu a eu lieu.
Pour les éléments <input>, voici les différents type (cf. input) pour lesquels l'attribut value contient une chaîne de caractères représentant une date ou une heure :
Avant de détailler plus, voyons quelques exemples de chaînes de caractères utilisées en HTML et qui représentent des valeurs temporelles.
Avant d'examiner les différents formats de chaînes de caractères de date et d'heure utilisés par les éléments HTML, il est utile de comprendre quelques faits fondamentaux sur la façon dont ils sont définis. HTML utilise une variante de la norme ISO 8601 pour ses chaînes de date et d'heure. Il est recommandé de relire les descriptions des formats que vous utilisez afin de vous assurer que vos chaînes sont bien compatibles avec HTML, car la spécification HTML inclut des algorithmes d'analyse de ces chaînes qui sont en réalité plus précis que ISO 8601, ce qui peut entraîner des différences subtiles dans la façon dont les chaînes de date et d'heure doivent être écrites.
En HTML, les chaînes qui représentent des dates et des heures manipulent uniquement des caractères ASCII.
Afin de simplifier le format de base utilisé pour les chaînes de caractères de date en HTML, la spécification exige que toutes les années soient indiquées selon le calendrier grégorien moderne (ou proleptique) calendrier grégorien. Bien que les interfaces utilisateur puissent permettre la saisie de dates selon d'autres calendriers, la valeur sous-jacente utilise toujours le calendrier grégorien.
Bien que le calendrier grégorien n'ait été créé qu'en 1582 (remplaçant le calendrier julien similaire), pour les besoins de HTML, le calendrier grégorien est étendu jusqu'à l'an 1 de notre ère. Veillez à ce que les dates plus anciennes en tiennent compte.
Pour les dates en HTML, les années comportent toujours au moins quatre chiffres ; les années antérieures à l'an 1000 sont complétées par des zéros initiaux (0), ainsi l'année 72 s'écrit 0072. Les années antérieures à l'an 1 de notre ère ne sont pas prises en charge, donc HTML ne prend pas en charge les années 1 avant notre ère (1 av. J.-C.) ou antérieures.
Une année compte normalement 365 jours, sauf pendant les années bissextiles.
Une année bissextile est toute année divisible par 400 ou divisible par 4 mais pas par 100. Bien que l'année calendaire compte normalement 365 jours, il faut en réalité environ 365,2422 jours à la planète Terre pour effectuer une orbite complète autour du soleil. Les années bissextiles permettent d'ajuster le calendrier afin de le maintenir synchronisé avec la position réelle de la planète sur son orbite. Ajouter un jour à l'année tous les quatre ans rend la durée moyenne d'une année égale à 365,25 jours, ce qui est proche de la réalité.
Les ajustements apportés à l'algorithme (prendre une année bissextile lorsque l'année est divisible par 400, et ignorer les années bissextiles lorsque l'année est divisible par 100) permettent d'approcher encore plus la valeur correcte (365,2425 jours). Les scientifiques ajoutent parfois des secondes intercalaires au calendrier (vraiment) pour gérer les trois dix-millièmes de jour restants et compenser le ralentissement naturel et progressif de la rotation de la Terre.
Le mois 02, février, compte normalement 28 jours, mais il en compte 29 lors des années bissextiles.
Une année comporte 12 mois, numérotés de 1 à 12. Ils sont toujours représentés par une chaîne de caractères ASCII sur deux chiffres dont la valeur varie de 01 à 12. Voir le tableau dans la section Jours du mois pour les numéros des mois et leurs noms correspondants (et leurs durées en jours).
Les mois numérotés 1, 3, 5, 7, 8, 10 et 12 possèdent 31 jours. Les mois 4, 6, 9 et 11 possèdent 30 jours. Le deuxième mois, février, possède 28 jours sauf pendant les années bissextiles où il possède 29 jours. Le tableau ci-après détaille les mois et leurs noms, ainsi que leur durée en jours.
Une chaîne de caractères représentant une semaine correspondra à une semaine d'une année donnée. Aussi, une chaîne de caractères valide pour représenter une semaine se compose de 4 chiffres représentant l'année, suivis d'un tiret ("-" ou U+002D), suivi de la lettre majuscule "W" (U+0057), suivie d'un numéro de semaine sur deux chiffres.
Le numéro de la semaine est une chaîne de caractères, avec deux chiffres, entre 01 et 53. Chaque semaine commence un lundi et se termine un dimanche. Il est ainsi possible que les premiers jours de janvier fassent partie de la dernière semaine de l'année précédente et que les derniers jours fassent partie de la première semaine de l'année suivante. La première semaine de l'année est celle qui contient le premier jeudi de l'année. Ainsi, le premier jeudi de 1953 était le 1er janvier et la semaine contenant ce jour est donc considérée la première semaine de l'année. Ainsi, le 30 décembre 1952 appartient à la semaine 1953-W01.
Une année aura 53 semaines si :
Les autres années contiennent 52 semaines.
On notera que les deux composantes pour l'année et pour la semaine sont complétées avec des zéros à gauche afin que l'année soit exprimée sur 4 chiffres et que la semaine soit exprimée sur 2 chiffres.
Une chaîne de caractères représentant un mois