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 {{HTMLElement("input")}} qui permettent de choisir une date, une heure ou les deux, les éléments {{HTMLElement("ins")}} et {{HTMLElement("del")}} dont l'attribut {{htmlattrxref("datetime", "ins")}} indique 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. {{htmlattrxref("type", "input")}}) pour lesquels l'attribut {{htmlattrxref("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.
| Chaîne de caractères | Date/heure | |
|---|---|---|
2005-06-07 |
7 juin 2005 | [détails] |
08:45 |
08h45m (le matin) | [détails] |
08:45:25 |
08h45m25s | [détails] |
0033-08-04T03:40 |
03h40 (du matin), le 04 août 33 | [détails] |
1977-04-01T14:00:30 |
30 secondes après 14h00, le premier avril 1977 | [détails] |
1901-01-01T00:00Z |
Minuit, UTC, le 1er janvier 1901 | [détails] |
1901-01-01T00:00:01-04:00 |
Minuit passé d'une seconde sur l'heure de l'Est (EST), le 1er janvier 1901 | [détails] |
Avant de s'intéresser aux différents formats pour la représentation textuelle des valeurs temporelles en HTML, commençons par décrire comment ces valeurs sont définies formellement. HTML utilise une variation du standard {{interwiki("wikipedia", "ISO 8601")}} pour les chaînes de caractères représentant les dates et les heures. Il est toujours utile de vérifier que le format utilisé est compatible avec HTML car la spécification HTML utilise des algorithmes pour analyser ces chaînes qui sont plus précis que le standard ISO 8601 (il peut donc y avoir quelques fines différences).
En HTML, les chaînes qui représentent des dates et des heures manipulent uniquement des caractères {{interwiki("wikipedia", "ASCII")}}.
La spécification HTML indique que les années doivent être exprimées selon le calendrier grégorien. Bien que les interfaces utilisateur permettent éventuellement de saisir des dates grâce à d'autres calendriers, la valeur sous-jacente est toujours représentée à l'aide du calendrier grégorien.
Bien que le calendrier grégorien ait été créé en 1582 afin de remplacer le calendrier julien, la notation grégorienne est « étendue » en HTML jusqu'à 1 après J.C. Aussi, si vous manipulez des dates antérieures à 1582, assurez-vous qu'elles soient bien exprimées selon le calendrier grégorien.
En HTML, les années sont toujours écrites avec au moins 4 chiffres. Aussi, les années antérieures à l'an 1000 sont complétées avec des zéros : l'an 72 est donc écrit 0072. Les années antérieures à l'an 1 ne sont pas prises en charge par HTML.
Une année est normalement constituée de 365 jours, sauf pendant les {{anch("Années bissextiles", "années bissextiles")}}.
Une année bissextile est une année dont le numéro est:
Bien qu'une année calendaire s'étende sur 365 jours, la Terre met environ 365,2422 jours avant d'effectuer une orbite complète autour du soleil. Les années bissextiles permettent d'ajuster le calendrier et de le synchroniser avec la position de la planète le long de l'orbite. Ajouter un jour tous les 4 ans (environ) permet d'avoir une année moyenne longue de 365,25 jours, ce qui est relativement correct.
En ajustant l'algorithme avec les contraintes ci-avant (divisible par 400 ou divisible par 4 mais pas par 100), on s'approche plus précisement du nombre correct de jours (365,2425). Des secondes intercalaires sont parfois ajoutées au calendrier afin de compenser les trois millièmes restant et le ralentissement naturel de la rotation de la Terre.
Le deuxième mois de l'année (février) possède 28 jours pendant les années non-bissextiles et 29 jours pendant les années bissextiles.
Une année comporte 12 mois, numérotés de 1 à 12. Les valeurs des mois sont toujours représentées par une chaîne de caractères se composant de deux chiffres : des valeurs entre 01 et 12. Voir le tableau ci-après pour les numéros des mois et le nombre de jours correspondant.
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.
| Numéro du mois | Nom (en français)) | Durée du mois (en nombre de jours) |
|---|---|---|
| 01 | Janvier | 31 |
| 02 | Février | 28 (29 pour les années bissextiles) |
| 03 | Mars | 31 |
| 04 | Avril | 30 |
| 05 | Mai | 31 |
| 06 | Juin | 30 |
| 07 | Juillet | 31 |
| o8 | Août | 31 |
| 09 | Septembre | 30 |
| 10 | Octobre | 31 |
| 11 | Novembre | 30 |
| 12 | Décembre | 31 |
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.
| Chaîne de caractères | Semaine et année (intervalle de dates) |
|---|---|
2001-W37 |
Semaine 37 de l'année 2001 (entre le 10 et le 16 septembre 2001) |
1953-W01 |
Semaine 1 de l'année 1953 (entre le 29 décembre 1952 et le 4 janvier 1953) |
1948-W53 |
Semaine 53 de l'année 1948 (entre le 27 décembre 1948 et le 2 janvier 1949) |
1949-W01 |
Semaine 1 de l'année 1949 (entre le 3 janvier et le 9 janvier 1949) |
0531-W16 |
Semaine 16 de l'année 531 (entre le 13 avril et le 19 avril 531) |
0042-W04 |
Semaine 4 de l'année 42 (entre le 21 et le 27 janvier 42) |
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 pour un mois représente un mois d'une année donnée (plutôt qu'un mois « générique »). Aussi, on ne représentera pas simplement le mois de janvier mais le mois de janvier de l'année 1972.
Une chaîne de caractères représentant un mois est valide si elle commence par un numéro d'année valide (une chaîne de caractères composée de quatre chiffres), suivie d'un tiret ("-", ou U+002D), suivi d'un nombre sur deux chiffres où 01 représente janvier et où 12 représente décembre.
| Chaîne de caractères | Le mois et l'année |
|---|---|
17310-09 |
Le mois de septembre de l'année 17310 |
2019-01 |
Le mois de janvier de l'année 2019 |
1993-11 |
Le mois de novembre de l'année 1993 |
0571-04 |
Le mois d'avril de l'année 571 |
0001-07 |
Le mois de juillet de l'an 1 |
On notera que les années sont exprimées sur au moins 4 chiffres et que les années antérieures à 1000 sont préfixées de 0.
Une chaîne de caractères représentant une date est valide si elle contient : une année (cf. ci-avant) suivie d'un tiret, suivi d'un mois, suivi d'un tiret ("-" ou U+002D) suivi du numéro du jour dans le mois sur deux chiffres.
| Chaîne de caractères | Date complète |
|---|---|
1993-11-01 |
1er novembre 1993 |
1066-10-14 |
14 octobre 1066 |
0571-04-22 |
22 avril 571 |
0062-02-05 |
5 février 62 |
Une chaîne de caractères représentant une heure peut décrire différentes précisions : minute, seconde ou milliseconde. Il n'est pas possible d'indiquer uniquement l'heure ou les minutes. Une chaîne valide se compose a minima d'une valeur sur deux chiffres représentant une heure, suivi de deux-points (":", U+003A) puis d'une valeur sur deux chiffres exprimant les minutes. La valeur des minutes peut ensuite être suivie d'un autre deux-points puis d'une valeur sur deux chiffres pour les secondes. Il est possible d'indiquer les millisecondes en ajoutant un point (".", U+002E) après les secondes, suivi d'une valeur sur un, deux ou trois chiffres.
Voici quelques règles supplémentaires :
00 correspond à minuit et où 23 correspond à onze heures du soir. Aucune valeur en dehors de l'intervalle 00–23 n'est autorisée.00 et 59. Les valeurs en dehors de cet intervalle ne sont pas autorisées.00 et 59. Il n'est pas possible d'indiquer des secondes intercalaires à l'aide de valeurs telles que 60 ou 61.| Chaîne de caractères | Heure |
|---|---|
00:00:30.75 |
Minuit passé de 30 secondes et 750 millisecondes |
12:15 |
Midi passé de quinze minutes |
13:44:25 |
13 heures 44 et 25 secondes |
Une chaîne de caractères datetime-local se compose d'une chaîne de caractères représentant une date, suivie de la lettre "T" ou d'une espace puis d'une chaîne de caractères représentant une heure. La représentation ne contient aucune information quant au fuseau horaire dont il est question et on présume que la valeur temporelle indiquée est relative au fuseau horaire de l'utilisateur.
Lorsqu'on définit la valeur de l'attribut {{htmlattrxref("value", "input")}} d'un champ datetime-local, la chaîne de caractères est normalisée. Les formes normalisées utilisent toujours la lettre T comme séparateur entre la date et l'heure. De plus, les formes normalisées utilisent toujours la forme la plus courte pour exprimer l'heure (les secondes sont omises si leur valeur est :00).
| Chaîne de caractères | Version normalisée | Date et heure correspondantes |
|---|---|---|
1986-01-28T11:38:00.01 |
1986-01-28T11:38:00.01 |
28 janvier 1986 à 11 heures et 38 minutes passées de 10 millisecondes |
1986-01-28 11:38:00.010 |
1986-01-28T11:38:00.011 |
28 janvier 1986 à 11 heures et 38 minutes passées de 10 millisecondes |
0170-07-31T22:00:00 |
0170-07-31T22:002 |
31 juillet 170 à 22 heures |
"T" et le zéro de terminaison a été supprimé pour raccourcir la chaîne de l'heure.Une valeur de date/heure universelle exprime la date et l'heure mais aussi le fuseau horaire de l'instant. Une chaîne de caractères représentant une telle valeur commence de la même façon qu'une chaîne de caractère représentant une date/heure locale, suivie d'une chaîne de caractères indiquant le décalage horaire.
La chaîne de caractères qui décrit le décalage horaire contient un décalage positif d'heures et de minutes, relativement à un fuseau de base. Il existe deux points de référence qui sont très proches sans être identiques :
Z et le décalage indique le décalage d'un fuseau horaire par rapport au méridien situé à la longitude 0° (méridien de Greenwich).La chaîne de caractères indiquant le décalage est directement ajoutée après la valeur pour la date et l'heure. Si la date et l'heure sont déjà exprimées relativement à UTC, on pourra simplement suffixer "Z", sinon, on construira le complément de la façon suivante :
+" ou U+002B) pour les fuseaux situés à l'est du méridien ou le moins ("-" ou U+002D) pour les fuseaux situés à l'ouest.00 et 23.:") (nécessaires uniquement si le décalage contient des minutes)00 et 59.Bien que ces règles permettent d'exprimer des fuseaux horaires entre -23:59 et +23:59, l'intervalle actuel des décalages horaires est -12:00 à +14:00 et il n'y a pas de fuseau horaire pour lequel le décalage en minutes est différent de 00, 30 ou 45. Cela peut en théorie évoluer à tout moment car les pays sont libres de modifier leur fuseau horaire quand ils le souhaitent.
| Chaîne de caractères | Date/heure universelle | Date/heure sur le méridien solaire |
|---|---|---|
2005-06-07T00:00Z |
7 juin 2005 à minuit UTC | 7 juin 2005 à minuit |
1789-08-22T12:30:00.1-04:00 |
22 août 1789 à midi trente (passé d'un dixième de seconde) selon l'heure avancée de l'Est (Eastern Daylight Time (EDT)) | 22 août 1789 à 16 heures trente passées d'un dixième de seconde |
3755-01-01 00:00+10:00 |
1er janvier 3755 à minuit pour le fuseau AEST (Australian Eastern Standard Time) | 31 décembre 3754 à 14h |
datetime qui permet de définir une date ou une date et une heure locales pour indiquer le moment où le contenu a été inséré ou suppriméIntl.DateTimeFormat qui permet de formater des dates et des heures pour une locale donnée