KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Intl.DateTimeFormat: datumonderdelen ophalen met formatToParts()

Haal de onderdelen van een lokaal opgemaakte datum of tijd op om bijvoorbeeld de maand te benadrukken, zonder tekst op scheidingstekens te splitsen of een vaste volgorde aan te nemen.

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

Syntax

formatter.formatToParts()
formatter.formatToParts(date)

formatToParts() is een instantiemethode van Intl.DateTimeFormat, gedefinieerd op Intl.DateTimeFormat.prototype, en geen statische methode van de constructor. Roep haar aan met formatter.formatToParts(date). Anders dan format() is de methode niet automatisch aan de instantie gebonden: een losse aanroep van de functie zonder de juiste this geeft een TypeError.

Geef een Date door of een tijdstempel in milliseconden sinds de Unix-epoch, niet in seconden. Zonder argument of met undefined wordt de huidige tijd van Date.now() gebruikt. Een ongeldige Date of een tijdstempel buiten het geldige bereik geeft een RangeError. De methode maakt waarden op en parseert geen datumtekst. Omgevingen met Temporal-integratie kunnen ook bepaalde Temporal.Plain*-typen accepteren; een rechtstreeks doorgegeven Temporal.ZonedDateTime geeft een TypeError.

Het resultaat is een array van { type, value }-objecten in weergavevolgorde; beide eigenschappen zijn tekenreeksen. Een type zoals month, day of year duidt een veld aan. literal staat voor tekst uit het patroon, bijvoorbeeld een komma, spatie of woord. Bij kalenders met jaarnamen kan relatedYear (het overeenkomstige Gregoriaanse jaar) in plaats van year verschijnen, en het patroon kan ook yearName (de naam van het jaar) bevatten.

Selecteer onderdelen op type, niet op hun index. Voeg alle value-tekenreeksen zonder scheidingsteken samen, ook die van type literal, om de uitvoer van format() met dezelfde instantie en datum te reproduceren. De landinstelling en opties zoals kalender en tijdzone beïnvloeden het resultaat. Spelling en interpunctie kunnen zelfs bij dezelfde landinstelling per omgeving verschillen. Gebruik het resultaat niet als gegevensuitwisselingsformaat.

Voorbeelden

const formatter = new Intl.DateTimeFormat("en-US", {
  timeZone: "UTC",
  year: "numeric",
  month: "long",
  day: "numeric",
});
const date = new Date("2024-07-09T12:00:00Z");
const parts = formatter.formatToParts(date);

console.log(parts.some(({ type }) => type === "month"));
console.log(parts.map(({ value }) => value).join("") === formatter.format(date));

Resultaat

true
true

Het voorbeeld legt de datum, de landinstelling en de UTC-tijdzone vast. De eerste `true` bevestigt dat er een `month`-onderdeel is; de tweede dat de samengevoegde waarden overeenkomen met `format()`.

Gerelateerde lessen

  • JavaScript · Les 15 · Basis · Versie: 4

Bronnen