Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Intl.RelativeTimeFormat — formatar o tempo relativo

Intl.RelativeTimeFormat cria descrições localizadas de tempo relativo. O método format(value, unit) recebe um número e uma unidade, não uma data; calcular a diferença de tempo continua a ser responsabilidade da aplicação.

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

Sintaxe

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

Intl.RelativeTimeFormat faz parte da norma de internacionalização ECMA-402, não das API do DOM. Crie uma instância com new. Aqui, RelativeTimeFormat.format designa o método de instância Intl.RelativeTimeFormat.prototype.format(value, unit), que devolve texto. Os números negativos descrevem o passado e os positivos o futuro; o método não calcula diferenças entre datas.

unit aceita second, minute, hour, day, week, month, quarter, year e as respetivas formas plurais em inglês. Uma unidade não suportada, NaN ou o infinito provocam um RangeError.

O valor predefinido numeric: "always" exclui expressões especiais como yesterday, mas o padrão da configuração regional pode exprimir a quantidade sem indicar explicitamente um número. Por exemplo, em árabe, a forma dual de um nome pode indicar dois dias sem um elemento numérico distinto. numeric: "auto" permite expressões como yesterday, quando disponíveis. style aceita long (o valor predefinido), short ou narrow.

O exemplo seleciona explicitamente en e valores fixos. O texto exato depende dos dados de localização. Verifique se o construtor e a localização necessária estão disponíveis no navegador de destino; a presença de Node 24 num repositório não comprova o suporte do navegador.

Exemplos

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

Resultado

yesterday
tomorrow

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes