Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Intl.RelativeTimeFormat — formater le temps relatif

Intl.RelativeTimeFormat crée des descriptions localisées du temps relatif. Sa méthode format(value, unit) prend un nombre et une unité, pas une date ; le calcul de la différence de temps reste à la charge de l’application.

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

Syntaxe

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

Intl.RelativeTimeFormat fait partie de la norme d’internationalisation ECMA-402, et non des API DOM. Créez une instance avec new. Ici, RelativeTimeFormat.format désigne la méthode d’instance Intl.RelativeTimeFormat.prototype.format(value, unit), qui renvoie du texte. Les nombres négatifs décrivent le passé et les nombres positifs le futur ; la méthode ne calcule pas les différences entre des dates.

unit accepte second, minute, hour, day, week, month, quarter, year ainsi que leurs formes plurielles anglaises. Une unité non prise en charge, NaN ou l’infini provoque une RangeError.

La valeur par défaut numeric: "always" écarte les expressions particulières comme yesterday, mais le modèle propre à la locale peut exprimer la quantité sans indiquer de nombre. Par exemple, en arabe, le duel d’un nom peut désigner deux jours sans élément numérique distinct. numeric: "auto" permet des expressions telles que yesterday lorsqu’elles sont disponibles. style accepte long (par défaut), short ou narrow.

L’exemple choisit explicitement en et des valeurs fixes. Le texte exact dépend des données de localisation. Vérifiez que le constructeur et la locale requise sont disponibles dans le navigateur cible ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par le navigateur.

Exemples

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

Résultat

yesterday
tomorrow

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources