KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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