Formations — 1 037 leçons en français

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 pipes date, number, currency et percent l'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 pipe currency quand aucun code n'est passé explicitement.

DatePipe

Pipe date qui 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 currency qui 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.

Lire l'explication détaillée et faire le quiz →

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.