Preferências usadas na apresentação
Um locale é um conjunto de preferências de idioma e convenções regionais que um programa usa para apresentar informações ou comparar textos. No JavaScript, o identificador pt-BR indica português com convenções do Brasil. A região é opcional, por isso pt também é um identificador válido, embora menos específico.
As funções de internacionalização consultam essas preferências para escolher a apresentação adequada à tarefa. O Intl.NumberFormat formata números e o Intl.DateTimeFormat formata datas e horas. Um identificador também pode especificar a escrita e incluir extensões, como a preferência por um calendário. Criar um objeto Intl.Locale apenas descreve essas preferências, sem aplicar a formatação por si só.
Um número, dois formatos
Neste exemplo em JavaScript, os dois formatadores recebem o número 1234.5 e produzem textos para exibição:
const valor = 1234.5const brasileiro = new Intl.NumberFormat('pt-BR')const americano = new Intl.NumberFormat('en-US')console.log(brasileiro.format(valor))console.log(americano.format(valor))Em ambientes com suporte a esses locales, as saídas usuais são 1.234,5 e 1,234.5. O ponto e a vírgula trocam de função na apresentação, mas o valor numérico continua sendo o mesmo. As convenções disponíveis podem variar entre implementações, conforme a especificação ECMA-402.
Formatação, tradução e entrada de números
O Intl.NumberFormat produz texto formatado e não oferece a conversão inversa de qualquer texto regional para número. Um campo que recebe 1.234,5 precisa de tratamento próprio para interpretar a entrada. Você não deve enviar esse texto diretamente para um cálculo supondo que todas as funções reconhecerão a vírgula decimal.
O locale também não define o fuso horário nem fornece as traduções das mensagens da interface. Para conferir a preferência efetivamente usada pelo formatador do exemplo, consulte brasileiro.resolvedOptions().locale. Esse resultado mostra a seleção feita pelo ambiente quando a preferência informada precisa ser ajustada ao suporte disponível.
Dúvidas frequentes
Perguntas frequentes sobre locale
- Locale e fuso horário são equivalentes?
- O locale orienta convenções de idioma e apresentação. O fuso horário determina como um instante corresponde à hora local. No Intl.DateTimeFormat, você pode configurar o locale e a opção timeZone separadamente.
- Definir um locale traduz as mensagens da aplicação?
- As mensagens precisam de traduções e de um mecanismo para selecioná-las. Escolher pt-BR em um formatador numérico muda a apresentação do número, mas não traduz botões ou textos da interface.
- Como conferir qual locale o JavaScript utilizou?
- O método resolvedOptions() do formatador informa o locale selecionado. O suporte depende do ambiente, portanto confira o resultado no navegador ou no servidor que executa a aplicação.
Para continuar
Recursos relacionados
Documentação
MDN: identificadores de idioma e região
Explica os identificadores Unicode de locale e os componentes de idioma, escrita e região.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Sessão ao vivo para investigar a formatação na aplicação e revisar os testes, com você operando o editor e o terminal.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao desenvolver uma interface com agentes, você precisa conferir se números e datas seguem o idioma e a região escolhidos.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.