Accueil › Angular › Dates, nombres et devises selon la locale
Dates, nombres et devises selon la locale
Internationalisation et accessibilitéintermediaire
Les pipes date, number, currency et percent formatent une valeur selon la locale active, définie par le jeton LOCALE_ID ('fr', 'en-US'…).
import { LOCALE_ID } from '@angular/core';
import { registerLocaleData } from '@angular/common';
import localeFr from '@angular/common/locales/fr';
registerLocaleData(localeFr);
// dans les providers de l'application
{ provide: LOCALE_ID, useValue: 'fr' }
Seule la locale en-US est incluse par défaut : toute autre locale doit être enregistrée avec registerLocaleData(), sinon Angular lève une erreur au premier formatage.
{{ produit.prix | currency:'EUR' }} <!-- 49,90 € -->
{{ commande.date | date:'longDate' }} <!-- 15 mars 2024 -->
{{ stock.tauxRemplissage | percent }} <!-- 82 % -->
DEFAULT_CURRENCY_CODE fixe la devise utilisée quand le pipe currency est appelé sans argument. Pour les dates, le piège le plus fréquent est le fuseau horaire : une date stockée en UTC doit être affichée avec un fuseau explicite si on veut l'heure locale de l'utilisateur, sinon le pipe utilise le fuseau du navigateur (ou de l'environnement d'exécution côté serveur, qui n'est pas toujours le même).
Les termes à connaître
- LOCALE_ID
Jeton d'injection qui définit la locale active de l'application (
'fr','en-US'…). Les pipesdate,number,currencyetpercentl'utilisent par défaut pour choisir leur format.- registerLocaleData
Fonction qui enregistre les données d'une locale (formats de date, séparateurs de nombres, symboles monétaires, pluriel…) auprès d'Angular. Nécessaire pour toute locale autre que
en-US, qui est incluse par défaut.- DEFAULT_CURRENCY_CODE
Jeton d'injection qui fixe le code devise ISO 4217 (
'EUR','USD'…) utilisé par le pipecurrencyquand aucun code n'est passé explicitement.- DatePipe
Pipe
datequi formate une date selon un format prédéfini ('short','medium','fullDate'…) ou personnalisé, en tenant compte de la locale et, en option, d'un fuseau horaire.- CurrencyPipe
Pipe
currencyqui formate un nombre en devise, avec le symbole, le nombre de décimales et la position du symbole propres à la locale active.- Intl
API JavaScript native (
Intl.DateTimeFormat,Intl.NumberFormat…) sur laquelle s'appuient en partie les pipes Angular, directement utilisable pour des besoins de formatage non couverts par les pipes.- Fuseau horaire
Décalage horaire appliqué à l'affichage d'une date. Une date stockée en UTC doit être explicitement convertie ou affichée avec le bon paramètre de fuseau, sinon elle apparaît décalée par rapport à l'heure attendue par l'utilisateur.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.