Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Intl.DateTimeFormat — formatage localisé des dates et heures

Intl.DateTimeFormat formate les dates et heures selon les conventions locales et un fuseau horaire choisi. Découvrez format(), formatToParts(), resolvedOptions() et la différence entre timeZone et hourCycle.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.formatToParts(date);
formatter.resolvedOptions();

Intl.DateTimeFormat fait partie de la norme d’internationalisation ECMA-402, et non de l’API DOM. Créez un formateur avec new Intl.DateTimeFormat(locales, options) et réutilisez-le. Une locale détermine les conventions de présentation ; elle ne choisit pas automatiquement le fuseau horaire correspondant au pays concerné.

Les noms Intl.DateTimeFormat.format et Intl.DateTimeFormat.formatToParts désignent ici des opérations d’instance, et non des méthodes statiques du constructeur. formatter.format(date) renvoie du texte ; la propriété format est un accesseur qui fournit une fonction liée. formatter.formatToParts(date) renvoie des objets { type, value } ordonnés, y compris des parties literal. La concaténation de toutes les valeurs value reconstitue format(date). Ne parsez pas un texte localisé en le découpant selon ses séparateurs.

timeZone, par exemple UTC ou Europe/Warsaw, choisit le fuseau utilisé pour afficher le même instant, sans modifier l’objet Date. Si l’option est omise, le fuseau horaire de l’environnement est utilisé. hourCycle définit la plage des heures : h11 correspond à 0–11, h12 à 1–12, h23 à 0–23 et h24 à 1–24. Cette option compte lors du formatage des heures ; si elle est fournie, l’option hour12 est prioritaire.

Intl.DateTimeFormat.prototype.resolvedOptions, appelé sous la forme formatter.resolvedOptions(), expose les réglages effectivement choisis, notamment locale, timeZone et, si le format inclut des heures, hourCycle. Les données de locale peuvent varier selon les environnements : ne supposez donc pas que la ponctuation ou les espaces seront identiques. La norme n’est pas un tableau de compatibilité des navigateurs : vérifiez les méthodes et options nécessaires dans vos environnements cibles ; Node 24 ne prouve pas leur prise en charge par les navigateurs.

Exemples

const formatter = new Intl.DateTimeFormat('en-GB', {
  timeZone: 'UTC',
  numberingSystem: 'latn',
  hour: '2-digit',
  minute: '2-digit',
  hourCycle: 'h23'
});
const date = new Date('2024-01-02T00:05:00Z');
const parts = formatter.formatToParts(date);
const field = type => parts.find(part => part.type === type).value;
console.log(`${field('hour')}:${field('minute')}`);
console.log(parts.map(part => part.value).join('') === formatter.format(date));
console.log(formatter.resolvedOptions().hourCycle);

Résultat

00:05
true
h23

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources