CKTIS / JavaScript
Intl.DateTimeFormat.prototype.format — formater une date et une heure selon une locale
Utilisez `formatter.format()` pour afficher une date et une heure selon une locale et un fuseau horaire. Le résultat est destiné à l’affichage, pas au stockage de données.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.format();
const format = formatter.format;
format(date);Appelez formatter.format(...) sur une instance de Intl.DateTimeFormat, et non sur le constructeur. Créez un objet de formatage avec new Intl.DateTimeFormat(locales, options) pour choisir la locale, le fuseau horaire et les champs à afficher. L’appel renvoie une chaîne et ne modifie pas l’objet Date. Si vous omettez locales ou timeZone, l’objet utilise la valeur par défaut correspondante de l’environnement d’exécution.
Dans ECMA-402 (2024), passez un objet Date ou un horodatage numérique en millisecondes depuis l’époque Unix, et non en secondes. Sans argument ou avec undefined, l’appel formate l’instant courant. format() n’analyse pas les chaînes de date : convertissez d’abord le texte en objet Date valide ou en horodatage. Un Date invalide, NaN, une valeur infinie ou un horodatage hors de la plage de Date déclenche une RangeError.
Intl.DateTimeFormat.prototype.format est une propriété dotée d’un getter. La lecture de formatter.format renvoie la même fonction liée à cette instance. Vous pouvez donc la passer directement comme fonction de rappel, par exemple avec dates.map(formatter.format), sans appeler bind().
Les environnements qui intègrent Temporal peuvent aussi formater Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth ou Temporal.PlainMonthDay si le type est compatible avec les réglages de l’objet de formatage. Temporal.ZonedDateTime déclenche une TypeError ; utilisez Temporal.ZonedDateTime.prototype.toLocaleString() pour formater la valeur dans son propre fuseau horaire.
Même avec les mêmes réglages, le résultat peut varier selon l’environnement, notamment pour les espaces, la ponctuation ou les caractères de contrôle bidirectionnel. Ne le comparez pas à un texte codé en dur et ne l’utilisez pas comme format d’échange de données.
Exemples
const formatter = new Intl.DateTimeFormat("en-GB", {
year: "numeric",
month: "long",
day: "numeric",
timeZone: "UTC",
});
const date = new Date("2024-06-15T00:00:00Z");
const format = formatter.format;
const text = formatter.format(date);
console.log(typeof text);
console.log(text === format(date.getTime()));Résultat
string true
L’exemple fixe l’instant, la locale et le fuseau UTC. Il vérifie le type du résultat et que la fonction appelée séparément formate un horodatage comme l’appel sur l’instance avec le `Date` équivalent, sans supposer le texte exact.
Leçons associées
- JavaScript · Leçon 15 · Débutant · Version : 4