CKTIS / JavaScript
Intl.RelativeTimeFormat.prototype.format() — форматиране на относително време
Преобразува отместване във времето със знак и изрично зададена единица в локализиран текст. Методът не изчислява разликата между дати.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
const formatter = new Intl.RelativeTimeFormat(locales, options);
formatter.format(value, unit);Intl.RelativeTimeFormat.prototype.format е метод на екземпляр. Извикването formatter.format(value, unit) връща низ според действително избраните езикови и регионални настройки и опциите, зададени в конструктора. Приложението изчислява отместването спрямо отправна точка и избира единицата; методът не отчита текущото време и не изважда дати.
Отрицателните стойности означават минало, а положителните — бъдеще. При числов шаблон -0 избира шаблона за минало, а +0 — този за бъдеще. unit приема точните идентификатори "second", "minute", "hour", "day", "week", "month", "quarter" и "year", както и формите им със завършващо s. Формата на идентификатора не определя граматичната форма на резултата.
numeric: "always" (по подразбиране) използва числов шаблон. numeric: "auto" използва специален израз като yesterday, ако е наличен, а иначе се връща към числов шаблон. style избира "long" (по подразбиране), "short" или "narrow". Поддръжката зависи от средата за изпълнение. Дори при едни и същи езикови и регионални настройки текстът може да се различава, например по употребата на непрекъсваеми интервали. В преносими тестове не сравнявай резултата с фиксиран текст.
Методът изисква екземпляр като this; самостоятелно извикване без валидно this води до TypeError. За функция за обратно извикване използвай formatter.format.bind(formatter). След проверката на this методът прилага ToNumber към value, а после ToString към unit. Например BigInt като value води до TypeError. След преобразуването NaN, Infinity, -Infinity или неподдържан идентификатор на единица води до RangeError.
Примери
{
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"));
}Резултат
1 day ago yesterday true
При едно и също отместване от `-1` ден първите два реда показват обичаен английски текст за `"always"` и `"auto"`. Третият показва, че `"day"` и `"days"` са равностойни.
Свързани уроци
- JavaScript · Урок 24 · Напреднало · Версия: 4
Източници
- ECMAScript® 2024 Internationalization API Specification — Intl.RelativeTimeFormat.prototype.format
- ECMAScript® 2024 Internationalization API Specification — PartitionRelativeTimePattern
- ECMAScript Internationalization API Specification (living draft) — Intl.RelativeTimeFormat.prototype.format
- Intl.RelativeTimeFormat.prototype.format() - JavaScript | MDN