CKTIS / JavaScript
Intl.RelativeTimeFormat.prototype.format() — relatieve tijd opmaken
Zet een tijdsverschil met teken en een expliciete eenheid om in gelokaliseerde tekst. De methode berekent zelf geen verschil tussen datums.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const formatter = new Intl.RelativeTimeFormat(locales, options);
formatter.format(value, unit);Intl.RelativeTimeFormat.prototype.format is een instantiemethode. formatter.format(value, unit) retourneert een tekenreeks volgens de daadwerkelijk gekozen taal- en regio-instelling en de opties die bij het aanmaken zijn vastgelegd. Je toepassing berekent het verschil ten opzichte van een referentiepunt en kiest de eenheid; de methode raadpleegt de klok niet en trekt geen datums van elkaar af.
Negatieve waarden duiden op het verleden, positieve op de toekomst. Bij een numeriek patroon kiest -0 het patroon voor het verleden en +0 dat voor de toekomst. unit accepteert precies "second", "minute", "hour", "day", "week", "month", "quarter" en "year", plus de vormen met een s erachter. De vorm van de identifier bepaalt niet de grammatica van de uitvoer.
numeric: "always" (standaard) gebruikt een numeriek patroon. numeric: "auto" gebruikt een vaste uitdrukking zoals yesterday als die beschikbaar is, en anders een numeriek patroon. Met style kies je "long" (standaard), "short" of "narrow". Ondersteuning hangt af van de uitvoeromgeving. Zelfs bij dezelfde taal- en regio-instelling kan de tekst verschillen, bijvoorbeeld door niet-afbrekende spaties. Vergelijk de uitvoer in overdraagbare tests niet met hardgecodeerde tekst.
De methode vereist een instantie als this; een losse aanroep zonder geldige this veroorzaakt TypeError. Gebruik formatter.format.bind(formatter) als je een callback nodig hebt. Na controle van this past de methode eerst ToNumber toe op value en daarna ToString op unit. Een BigInt als value veroorzaakt bijvoorbeeld TypeError. Na conversie leidt NaN, Infinity, -Infinity of een niet-ondersteunde eenheidsidentifier tot RangeError.
Voorbeelden
{
const numeric = new Intl.RelativeTimeFormat("en", { numeric: "always" });
const auto = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
const past = numeric.format(-1, "day");
console.log(past);
console.log(auto.format(-1, "day"));
console.log(past === numeric.format(-1, "days"));
}Resultaat
1 day ago yesterday true
Voor hetzelfde verschil van `-1` dag tonen de eerste twee regels gebruikelijke Engelse tekst voor `"always"` en `"auto"`. De derde toont dat `"day"` en `"days"` gelijkwaardig zijn.
Gerelateerde lessen
- JavaScript · Les 24 · Gevorderd · Versie: 4
Bronnen
- ECMAScript® 2024 Internationalization API Specification — Intl.RelativeTimeFormat.prototype.format
- ECMAScript® 2024 Internationalization API Specification — PartitionRelativeTimePattern
- ECMAScript Internationalization API Specification (living draft) — Intl.RelativeTimeFormat.prototype.format
- Intl.RelativeTimeFormat.prototype.format() - JavaScript | MDN