KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Intl.RelativeTimeFormat — relatieve tijd formatteren

Intl.RelativeTimeFormat maakt gelokaliseerde beschrijvingen van relatieve tijd. De methode format(value, unit) neemt een getal en een eenheid, geen datum; het berekenen van het tijdsverschil blijft de verantwoordelijkheid van de toepassing.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const rtf = new Intl.RelativeTimeFormat(locales, { numeric: "auto", style: "long" });
rtf.format(value, unit);

Intl.RelativeTimeFormat hoort bij de internationaliseringsstandaard ECMA-402, niet bij de DOM-API’s. Maak een instantie met new. Hier verwijst RelativeTimeFormat.format naar de instantiemethode Intl.RelativeTimeFormat.prototype.format(value, unit), die tekst teruggeeft. Negatieve getallen beschrijven het verleden en positieve getallen de toekomst; de methode berekent geen verschillen tussen datums.

unit accepteert second, minute, hour, day, week, month, quarter, year en de Engelse meervoudsvormen daarvan. Een niet-ondersteunde eenheid, NaN of oneindigheid veroorzaakt een RangeError.

Met de standaardwaarde numeric: "always" worden speciale uitdrukkingen zoals yesterday overgeslagen, maar het patroon voor de landinstelling kan een hoeveelheid uitdrukken zonder expliciet een getal te vermelden. In het Arabisch kan de tweevoudsvorm van een zelfstandig naamwoord bijvoorbeeld twee dagen aanduiden zonder een apart getal. numeric: "auto" staat uitdrukkingen zoals yesterday toe wanneer die beschikbaar zijn. style accepteert long (de standaard), short of narrow.

Het voorbeeld kiest expliciet en en vaste waarden. De exacte tekst hangt af van de lokalisatiegegevens. Controleer of de constructor en de vereiste taal beschikbaar zijn in de doelbrowser; de aanwezigheid van Node 24 in een repository bewijst niet dat de browser dit ondersteunt.

Voorbeelden

const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
console.log(rtf.format(-1, "day"));
console.log(rtf.format(1, "day"));

Resultaat

yesterday
tomorrow

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen