CKTIS / JavaScript
Intl.RelativeTimeFormat — форматиране на относително време
Intl.RelativeTimeFormat създава локализирани описания на относително време. Методът format(value, unit) приема число и единица, а не дата; изчисляването на времевата разлика остава отговорност на приложението.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const rtf = new Intl.RelativeTimeFormat(locales, { numeric: "auto", style: "long" });
rtf.format(value, unit);Intl.RelativeTimeFormat е част от стандарта за интернационализация ECMA-402, а не от DOM API-тата. Създайте екземпляр с new. Тук RelativeTimeFormat.format означава метода на екземпляра Intl.RelativeTimeFormat.prototype.format(value, unit), който връща текст. Отрицателните числа описват миналото, а положителните — бъдещето; методът не изчислява разлики между дати.
unit приема second, minute, hour, day, week, month, quarter, year и английските им форми за множествено число. Неподдържана единица, NaN или безкрайност предизвикват RangeError.
При стойността по подразбиране numeric: "always" не се използват специални изрази като yesterday, но шаблонът за съответната локализация може да изрази количество, без да посочва изрично число. Например в арабския език формата за двойствено число на съществителното може да означава два дни без отделен числов елемент. numeric: "auto" позволява изрази като yesterday, когато са налични. style приема long (по подразбиране), short или narrow.
Примерът изрично избира en и фиксирани стойности. Точният текст зависи от локализационните данни. Проверете дали конструкторът и необходимата локализация са налични в целевия браузър; наличието на Node 24 в хранилище не доказва поддръжка от браузъра.
Примери
const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
console.log(rtf.format(-1, "day"));
console.log(rtf.format(1, "day"));Резултат
yesterday tomorrow
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.