KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Intl.DateTimeFormat.prototype.format — datum en tijd lokaal weergeven

Gebruik `formatter.format()` om een datum en tijd weer te geven volgens de gewenste taalregio en tijdzone. Het resultaat is tekst voor weergave, geen formaat voor gegevensopslag.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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

Roep formatter.format(...) aan op een instantie van Intl.DateTimeFormat, niet op de constructor. Maak een formatter met new Intl.DateTimeFormat(locales, options) om de taalregio, tijdzone en weer te geven velden te kiezen. De aanroep geeft een tekenreeks terug en wijzigt het Date-object niet. Laat je locales of timeZone weg, dan gebruikt de formatter de bijbehorende standaardwaarde van de uitvoeringsomgeving.

In ECMA-402 (2024) geef je een Date of een numerieke tijdstempel door in milliseconden sinds het Unix-tijdperk, niet in seconden. Zonder argument of met undefined formatteert de aanroep het huidige tijdstip. format() ontleedt geen datumtekst: zet die eerst om in een geldige Date of tijdstempel. Een ongeldige Date, NaN, oneindigheid of een tijdstempel buiten het bereik van Date leidt tot een RangeError.

Intl.DateTimeFormat.prototype.format is een eigenschap met een getter. Het lezen van formatter.format levert dezelfde functie op, gebonden aan die instantie. Je kunt die dus direct als callback doorgeven, bijvoorbeeld met dates.map(formatter.format), zonder bind() aan te roepen.

Uitvoeringsomgevingen met Temporal-integratie kunnen ook Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth of Temporal.PlainMonthDay formatteren als het type bij de instellingen van de formatter past. Temporal.ZonedDateTime leidt tot een TypeError; gebruik Temporal.ZonedDateTime.prototype.toLocaleString() om de waarde in de eigen tijdzone te formatteren.

Zelfs met dezelfde instellingen kan de uitvoer per omgeving verschillen, bijvoorbeeld in spaties, leestekens of besturingstekens voor de tekstrichting. Vergelijk de uitvoer niet met hardgecodeerde tekst en gebruik die niet als formaat voor gegevensuitwisseling.

Voorbeelden

const formatter = new Intl.DateTimeFormat("en-GB", {
  year: "numeric",
  month: "long",
  day: "numeric",
  timeZone: "UTC",
});
const date = new Date("2024-06-15T00:00:00Z");
const format = formatter.format;
const text = formatter.format(date);

console.log(typeof text);
console.log(text === format(date.getTime()));

Resultaat

string
true

Het voorbeeld legt het tijdstip, de taalregio en de UTC-tijdzone vast. Het controleert het resultaattype en of de los aangeroepen functie een tijdstempel op dezelfde manier formatteert als de aanroep op de instantie met de overeenkomstige `Date`, zonder de exacte tekst te veronderstellen.

Gerelateerde lessen

  • JavaScript · Les 15 · Basis · Versie: 4

Bronnen