Aula 92 — Introdução ao Intl

Até aqui, já lidamos com datas, números e textos no JavaScript.

Mas aplicações reais precisam lidar com algo a mais:

idiomas, formatos regionais e culturas diferentes.

É exatamente isso que a API Intl resolve.

🎯 Objetivo da aula

Ao final desta aula, você será capaz de:

• Entender o papel da API Intl
• Formatar números corretamente
• Formatar moedas por localidade
• Trabalhar com datas internacionais
• Evitar erros comuns de formatação manual

O problema da formatação manual

Veja este exemplo comum:

 
  const valor = 1234567.89;
  console.log("R$ " + valor.toFixed(2));
  // Saída será: R$ 1234567.89

Problemas:

• separadores errados
• formato fixo
• não respeita localidade

O que é a API Intl?

Intl é uma API nativa do JavaScript para:

• internacionalização
• localização
• formatação cultural correta

Ela já entende regras de dezenas de países.

Formatando números corretamente

 
  const numero = 1234567.89;
  const formatadorBR = new Intl.NumberFormat("pt-BR");
  const formatadorUS = new Intl.NumberFormat("en-US");
  console.log(formatadorBR.format(numero)); // Saída será: 1.234.567,89
  console.log(formatadorUS.format(numero)); // Saída será: 1,234,567.89

O mesmo número, dois formatos diferentes — automaticamente.

Formatando moedas

 
  const valor = 1999.9;
  const real = new Intl.NumberFormat("pt-BR", {
    style: "currency", currency: "BRL"
  });
  const dolar = new Intl.NumberFormat("en-US", {
    style: "currency", currency: "USD"
  });
  console.log(real.format(valor)); // Saída será: R$ 1.999,90
  console.log(dolar.format(valor)); // Saída será: $1,999.90

Formatando datas corretamente

Datas variam muito entre países.

 
  const data = new Date("2026-01-21");
  const dataBR = new Intl.DateTimeFormat("pt-BR");
  const dataUS = new Intl.DateTimeFormat("en-US");
  console.log(dataBR.format(data)); // Saída será: 21/01/2026
  console.log(dataUS.format(data)); // Saída será: 1/21/2026

Datas com opções avançadas

 
  const formatador = new Intl.DateTimeFormat("pt-BR", { 
    weekday: "long", year: "numeric", month: "long", day: "numeric" 
  });
  console.log(formatador.format(new Date()));
  // Saída será algo como: quarta-feira, 21 de janeiro de 2026

Perceba:

• nome do dia
• mês por extenso
• idioma correto

Comparação de strings com Intl.Collator

Ordenar textos também depende de idioma.

  const palavras = ["ábaco", "abacate", "ábaco", "ação"];
  palavras.sort(new Intl.Collator("pt-BR").compare);
  console.log(palavras);
  // Saída será uma ordenação correta para português

Quando usar Intl?

• aplicações multilíngues
• e-commerce
• dashboards financeiros
• sistemas globais

Quando NÃO usar Intl?

• scripts muito simples
• formatos fixos internos

Mesmo assim, conhecer a API evita decisões ruins no futuro.

Integração com tudo que você já aprendeu

• Promises → dados assíncronos
• Async/await → fluxo claro
• Top-level await → módulos organizados
• Intl → saída correta para o usuário

Com isso, encerramos o bloco de novidades modernas do JavaScript. Na próxima aula veremos os problemas do objeto Date.