CKTIS / JavaScript
Intl.DateTimeFormat.formatToParts(): onderdelen van datum en tijd
Haal de onderdelen van een gelokaliseerde datum of tijd op om één onderdeel op te maken zonder de veldvolgorde te raden of de tekst op leestekens te splitsen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
formatter.formatToParts()
formatter.formatToParts(date)Intl.DateTimeFormat.prototype.formatToParts is een instantiemethode van Intl.DateTimeFormat. In plaats van de ene tekenreeks van format() geeft de methode een array van { type, value }-objecten in weergavevolgorde. Beide eigenschappen zijn tekenreeksen. Voeg alle value-waarden samen met join("") om voor dezelfde formatter en invoer het resultaat van format() te krijgen. Anders dan de functie die format teruggeeft, is formatToParts niet automatisch aan de instantie gebonden. Geef date => formatter.formatToParts(date) als callback door of gebruik bind; een ongeschikte this leidt tot een TypeError.
Selecteer onderdelen op type, zoals month of dayPeriod, niet op array-index. Behoud literal-onderdelen: ze kunnen spaties, leestekens of woorden bevatten. In sommige kalenders verschijnt relatedYear (het overeenkomstige gregoriaanse jaar) in plaats van year, soms samen met yearName (de naam van het jaar). Behoud ook onbekende onderdelen. De landinstelling, opties en gegevens van de runtime kunnen de uitvoer beïnvloeden. Gebruik de onderdelen voor weergave, niet om invoer te ontleden of gegevens op te slaan. Voeg de waarden in de browser als tekst in met textContent, niet met innerHTML.
Geef in ECMA-402 voor ECMAScript 2024 een Date of een aantal milliseconden sinds de Unix-epoch door. De methode zet het argument om in een getal; datumtekenreeksen worden niet als datum geïnterpreteerd. Zonder argument of met undefined gebruikt de methode de huidige tijd op het moment van aanroepen. Een ongeldige Date of een tijdstempel buiten het geldige bereik leidt tot een RangeError.
Runtimes met Temporal-integratie accepteren ook Temporal.Instant en de voor deze methode gespecificeerde Temporal.Plain*-typen, met beperkingen voor de kalender en opmaak die per type verschillen. Controleer de ondersteuning in je doelomgeving. Als je rechtstreeks een Temporal.ZonedDateTime doorgeeft, krijg je een TypeError. Wil je onderdelen voor hetzelfde tijdstip in de bijbehorende tijdzone, geef dan het resultaat van toInstant() door en stel timeZone van de formatter in op de tijdzone van dat object.
Voorbeelden
{
const formatter = new Intl.DateTimeFormat("en-US", {
timeZone: "UTC",
calendar: "gregory",
year: "numeric",
month: "long",
day: "numeric",
});
const date = new Date("2024-07-05T12: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 het tijdstip, de landinstelling en de UTC-tijdzone vast. De eerste `true` bevestigt dat er een `month`-onderdeel is. De tweede bevestigt dat de samengevoegde waarden overeenkomen met `format(date)`, zonder specifieke scheidingstekens te veronderstellen.
Gerelateerde lessen
- JavaScript · Les 25 · Gevorderd · Versie: 4