CKTIS / JavaScript
Intl.DateTimeFormat : obtenir les parties d’une date avec formatToParts()
Récupérez les parties d’une date ou d’une heure localisée pour mettre en évidence le mois, par exemple, sans découper le texte selon des séparateurs ni supposer l’ordre des champs.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
formatter.formatToParts()
formatter.formatToParts(date)formatToParts() est une méthode d’instance de Intl.DateTimeFormat, définie sur Intl.DateTimeFormat.prototype, et non une méthode statique du constructeur. Appelez-la avec formatter.formatToParts(date). Contrairement à format(), elle n’est pas automatiquement liée à l’instance : appeler la fonction extraite sans le bon this lève une TypeError.
Passez un objet Date ou un horodatage en millisecondes depuis l’époque Unix, et non en secondes. Sans argument ou avec undefined, la méthode utilise l’heure courante fournie par Date.now(). Un Date invalide ou un horodatage hors limites provoque une RangeError. La méthode met en forme des valeurs ; elle n’analyse pas de texte représentant une date. Les environnements qui intègrent Temporal peuvent aussi accepter certains types Temporal.Plain* ; passer directement un Temporal.ZonedDateTime lève une TypeError.
Le résultat est un tableau d’objets { type, value } dans l’ordre d’affichage ; les deux propriétés sont des chaînes. Un type tel que month, day ou year identifie un champ. literal désigne du texte du motif, par exemple une virgule, une espace ou un mot. Dans les calendriers où les années portent un nom, relatedYear (l’année grégorienne correspondante) peut remplacer year, et le motif peut aussi contenir yearName (le nom de l’année).
Sélectionnez les parties par type, pas par indice. Pour retrouver le résultat de format() avec la même instance et la même date, concaténez toutes les chaînes value sans séparateur, y compris celles de type literal. Les paramètres régionaux et des options comme le calendrier et le fuseau horaire influencent le résultat. La graphie et la ponctuation peuvent varier selon l’environnement, même avec les mêmes paramètres régionaux. N’utilisez pas le résultat comme format d’échange de données.
Exemples
const formatter = new Intl.DateTimeFormat("en-US", {
timeZone: "UTC",
year: "numeric",
month: "long",
day: "numeric",
});
const date = new Date("2024-07-09T12:00:00Z");
const parts = formatter.formatToParts(date);
console.log(parts.some(({ type }) => type === "month"));
console.log(parts.map(({ value }) => value).join("") === formatter.format(date));Résultat
true true
L’exemple fixe la date, les paramètres régionaux et le fuseau UTC. Le premier `true` confirme la présence d’une partie `month` ; le second confirme que les valeurs concaténées correspondent à `format()`.
Leçons associées
- JavaScript · Leçon 15 · Débutant · Version : 4