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
- ECMAScript® 2027 Internationalization API Specification
- ECMAScript® 2024 Internationalization API Specification
- ECMAScript® 2026 Internationalization API Specification
- Official reference — tc39.es: ecma402
- Official reference — tc39.es: ecma402
- Official reference — developer.mozilla.org: Intl / DateTimeFormat