CKTIS / JavaScript
Fuseaux horaires et cycles horaires dans Intl.DateTimeFormat
`timeZone` choisit l’heure locale à afficher pour un instant. `hourCycle` règle la numérotation des heures, notamment l’affichage de minuit sous la forme `00` ou `24`.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
new Intl.DateTimeFormat(locales, { timeZone, hourCycle, hour: "2-digit" })timeZone choisit le fuseau utilisé pour afficher un instant, sans modifier l’objet Date ni sa valeur. Si l’option est omise, le fuseau par défaut de l’environnement d’exécution s’applique. Un fuseau nommé comme "America/New_York" suit les règles en vigueur à cet instant, dont les changements d’heure saisonniers. Un décalage fixe tel que "-05:00" ne suit pas ces règles. Les anciens environnements peuvent ne pas accepter les identifiants de décalage. timeZoneName règle le libellé affiché, pas le choix du fuseau.
hourCycle fixe la plage des heures : "h11" correspond à 0–11, "h12" à 1–12, "h23" à 0–23 et "h24" à 1–24. Avec "h24", 24 désigne l’heure qui commence à minuit, sans déplacer l’instant au lendemain. hourCycle n’ajoute pas d’heure à lui seul : demandez-la avec hour ou timeStyle, sans combiner ces deux options.
hour12: true et hour12: false sont prioritaires sur hourCycle et sur l’extension Unicode hc du paramètre de langue et de région. true choisit un cycle de 12 heures et false un cycle de 24 heures. Pour imposer un cycle précis, omettez hour12 et définissez hourCycle, qui prime sur hc. Sans ces réglages, le cycle par défaut dépend de la langue et de la région sélectionnées.
Une valeur hourCycle invalide ou un identifiant timeZone non reconnu déclenche une RangeError à la création du formateur, même si une valeur hour12 valide devait primer sur hourCycle. Consultez les réglages effectifs avec resolvedOptions() : le cycle est absent si le format ne contient pas d’heure. Pour extraire l’heure seule, utilisez la partie hour de formatToParts() plutôt que d’analyser toute la chaîne localisée.
Exemples
const instant = new Date("2024-01-15T05:00:00Z");
function showHour(timeZone, hourCycle) {
const formatter = new Intl.DateTimeFormat("en-US", {
timeZone,
hourCycle,
hour: "2-digit",
numberingSystem: "latn",
formatMatcher: "basic",
});
const hour = formatter.formatToParts(instant).find(part => part.type === "hour");
const displayHour = hour.value.padStart(2, "0");
console.log(`${timeZone} ${formatter.resolvedOptions().hourCycle}: ${displayHour}`);
}
showHour("UTC", "h23");
showHour("America/New_York", "h23");
showHour("America/New_York", "h24");Résultat
UTC h23: 05 America/New_York h23: 00 America/New_York h24: 24
Seul le fuseau change entre les deux premières lignes : le même instant tombe à `05` heures en UTC et à minuit à New York. La dernière ligne change seulement le cycle, de sorte que la même heure locale s’affiche comme `24` au lieu de `00`.
Leçons associées
- JavaScript · Leçon 25 · Avancé · Version : 4
Sources
- ECMAScript® 2024 Internationalization API Specification — CreateDateTimeFormat
- ECMAScript Internationalization API Specification — CreateDateTimeFormat (living specification)
- Intl.DateTimeFormat() constructor — MDN
- Intl.DateTimeFormat.prototype.resolvedOptions() — MDN
- Intl.DateTimeFormat.prototype.formatToParts() — MDN