CKTIS / JavaScript
Intl.DateTimeFormat — gelokaliseerde datum- en tijdnotatie
Intl.DateTimeFormat geeft datums en tijden weer volgens localeconventies en een gekozen tijdzone. Leer meer over format(), formatToParts(), resolvedOptions() en het verschil tussen timeZone en hourCycle.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.formatToParts(date);
formatter.resolvedOptions();Intl.DateTimeFormat maakt deel uit van de internationalisatiestandaard ECMA-402, niet van de DOM-API. Maak een formatter met new Intl.DateTimeFormat(locales, options) en hergebruik die. Een locale bepaalt de weergaveconventies; deze kiest niet automatisch de tijdzone die bij het betreffende land hoort.
De namen Intl.DateTimeFormat.format en Intl.DateTimeFormat.formatToParts verwijzen hier naar instantieoperaties, niet naar statische methoden van de constructor. formatter.format(date) retourneert tekst; de eigenschap format is een accessor die een gebonden functie beschikbaar maakt. formatter.formatToParts(date) retourneert geordende { type, value }-objecten, inclusief literal-delen. Door alle value-waarden samen te voegen, reconstrueer je format(date). Parse gelokaliseerde tekst niet door die op scheidingstekens te splitsen.
timeZone, zoals UTC of Europe/Warsaw, kiest de zone voor het weergeven van hetzelfde moment, zonder het Date-object te wijzigen. Als je de optie weglaat, wordt de tijdzone van de omgeving gebruikt. hourCycle bepaalt het urenbereik: h11 is 0–11, h12 is 1–12, h23 is 0–23 en h24 is 1–24. Deze optie is van belang bij het formatteren van uren; als hour12 is opgegeven, heeft die optie voorrang.
Intl.DateTimeFormat.prototype.resolvedOptions, aangeroepen als formatter.resolvedOptions(), toont de daadwerkelijk gekozen instellingen, waaronder locale, timeZone en, wanneer de opmaak uren bevat, hourCycle. Localedata kunnen per omgeving verschillen, dus ga niet uit van identieke interpunctie of spatiëring. De standaard is geen browsercompatibiliteitstabel: controleer de vereiste methoden en opties in je doelomgevingen; Node 24 bewijst geen ondersteuning in browsers.
Voorbeelden
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);Resultaat
00:05 true h23
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.
Bronnen
- 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