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.