Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é locale?

    Um locale identifica preferências de idioma e região usadas para apresentar números e datas. No JavaScript, ele orienta as funções de internacionalização.

    Também chamado de: identificador de locale

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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.5
    const 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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano