База знанияИзпитен център
BGБългарски
Избери език13

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

Източници