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.