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

CKTIS / JavaScript

Internacionalização (i18n)

A internacionalização prepara um programa para diferentes línguas e convenções regionais. Em JavaScript, Intl disponibiliza operações sensíveis à região, mas não traduz automaticamente o conteúdo de uma 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

new Intl.NumberFormat(locales, options).format(value)

A internacionalização (internationalization, abreviada i18n) consiste em conceber um programa de modo a que possa ser adaptado a diferentes línguas e regiões. A localização é uma adaptação concreta, que inclui, por exemplo, traduções e formatos de apresentação de dados. Mantenha o texto da interface separado da lógica do programa.

A ECMA-262 define a linguagem JavaScript, enquanto a ECMA-402 define a API Intl. Intl.NumberFormat formata números, Intl.DateTimeFormat formata datas e Intl.Collator compara texto segundo regras regionais. Intl não traduz frases arbitrárias. Uma etiqueta como en-US identifica as preferências regionais; por si só, não seleciona uma moeda nem um fuso horário.

Indique explicitamente a região e as opções necessárias. Os dados regionais disponíveis e os detalhes do resultado podem depender do ambiente de execução. O exemplo desativa a agrupação e fixa duas casas decimais; o resultado esperado pressupõe suporte para en-US. Não utilize o texto de apresentação como formato de armazenamento de dados.

O exemplo utiliza funcionalidades especificadas na ECMA-402:2024, não APIs de browser. Uma especificação, por si só, não estabelece a compatibilidade com um browser específico; verifique os ambientes de destino e os dados regionais. A presença do Node 24 no repositório não comprova o suporte nos browsers.

Exemplos

const formatter = new Intl.NumberFormat("en-US", {
  numberingSystem: "latn",
  useGrouping: false,
  minimumFractionDigits: 2,
  maximumFractionDigits: 2
});

console.log(formatter.format(1234.5));

Resultado

1234.50

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