Formatar data em JavaScript: gerador e exemplos
Formato de data em JavaScript
Formatar data em JavaScript: gerador de Intl.DateTimeFormat e exemplos | We.Inc
Formate datas em JavaScript sem biblioteca: um gerador de Intl.DateTimeFormat ao vivo, código para YYYY-MM-DD e MM/DD/YYYY, fusos horários, tempo relativo, intervalos e as armadilhas de parsing por trás dos bugs de um dia a menos.
Para formatar uma data em JavaScript, use Intl.DateTimeFormat ou toLocaleDateString com um locale e opções, por exemplo date.toLocaleDateString("en-US", { dateStyle: "long" }) para March 5, 2026. Use toISOString() para APIs, a opção timeZone para mostrar outro fuso e Intl.RelativeTimeFormat para expressões como há 3 dias.
Respostas rápidas
- Necessidade
- Use
- Armazenar ou enviar uma data
- toISOString()
- Mostrar uma data para pessoas
- Intl.DateTimeFormat / toLocaleDateString
- Outro fuso horário
- a opção timeZone
- "há 3 dias"
- Intl.RelativeTimeFormat
Escolha um locale e as opções no gerador e copie o código que ele escreve; a prévia é formatada pelo seu próprio navegador. Abaixo dele, uma tabela de formatos do dia a dia e exemplos executáveis para fusos, tempo relativo e intervalos.
- Escolha um locale, ou digite qualquer tag BCP 47, como fr-CA.
- Escolha um estilo predefinido, ou defina cada parte separadamente.
- Se quiser, defina um fuso horário e o formato de 12 ou 24 horas.
- Copie o código gerado para o seu projeto.
- Crie um único Intl.DateTimeFormat e reutilize-o em loops; construir o formatador é a parte lenta.
- Armazene e envie em UTC (strings ISO ou timestamps) e converta para o horário local só na hora de exibir.
- Passe o locale do visitante (navigator.language) em vez de fixar en-US quando o público for internacional.
- Evite fazer parsing de strings ambíguas como 03/05/2026; monte as datas a partir de números ou de strings ISO.
Perguntas frequentes
Como formato uma data como YYYY-MM-DD em JavaScript?
Use o ano local, o mês mais um e o dia, completados com padStart(2, "0"), e junte-os com hífens. toISOString().slice(0, 10) também gera esse formato, mas em UTC, então pode mostrar o dia errado perto da meia-noite.
Por que a minha data está com um dia de diferença?
new Date("2026-03-05") é lido como meia-noite UTC. A oeste de Greenwich, esse instante ainda é dia 4 no horário local. Faça o parsing com uma hora ("2026-03-05T00:00") ou com new Date(2026, 2, 5) para obter a meia-noite local.
Ainda preciso do Moment.js?
Não para formatar. O Intl cobre locales, fusos horários e tempo relativo em todos os navegadores modernos. Os próprios mantenedores do Moment o descrevem como um projeto legado; para aritmética de datas, uma biblioteca pequena como date-fns ou a API Temporal, mais nova (onde estiver disponível), funciona bem.
Como mostro um horário em um fuso específico?
Passe timeZone com um nome IANA, por exemplo { timeZone: "America/New_York", timeStyle: "short" }. O objeto Date continua sendo o mesmo instante; só muda a forma como ele é escrito.
Datas em um site de negócio
- Horários de funcionamento, datas de eventos e datas de posts devem seguir o jeito como os seus visitantes as escrevem. Um público britânico lê 05/03 como 5 de março, um americano como 3 de maio, então escreva o mês por extenso (5 March 2026) sempre que o público for misto.
- Para datas legíveis por máquina, como em um elemento HTML time ou em dados estruturados, use a forma ISO no atributo datetime e a forma amigável como texto visível.
Formatos comuns
Formatos comuns e o código de cada um
- Você quer
- Código
- Resultado (en-US, 5 de março de 2026, 14:07)
- ISO 8601 para APIs
- d.toISOString()
- O mesmo instante em UTC, terminando em Z
- YYYY-MM-DD no horário local
- d.toLocaleDateString("en-CA")
- MM/DD/YYYY
- d.toLocaleDateString("en-US", { month: "2-digit", day: "2-digit", year: "numeric" })
- DD/MM/YYYY
- d.toLocaleDateString("en-GB")
- Data por extenso
- d.toLocaleDateString("en-US", { dateStyle: "long" })
- March 5, 2026
- Dia da semana e data
- {weekday:"long", month:"long", day:"numeric"}
- Thursday, March 5
- Hora, 12 horas
- d.toLocaleTimeString("en-US", { timeStyle: "short" })
- 2:07 PM
- Hora, 24 horas
- {hour:"2-digit", minute:"2-digit", hourCycle:"h23"}
- Relativo
- new Intl.RelativeTimeFormat("en", { numeric: "auto" }).format(-1, "day")
Exemplos executáveis
Fazendo parsing de datas com segurança
Uma string ISO só com data é lida como meia-noite UTC, mas uma string de data e hora sem offset é lida como horário local. Essa diferença causa a maioria dos bugs de um dia a menos.
YYYY-MM-DD sem biblioteca
Monte a partir das partes locais com padStart. O truque do locale en-CA dá o mesmo resultado, mas depende de o formato desse locale continuar igual.
O mesmo instante em vários fusos horários
timeZone recebe um nome IANA. O Date em si não tem fuso; só a formatação muda. Note que timeZoneName não pode ser combinado com dateStyle ou timeStyle.
Tempo relativo (há 3 dias, em 2 horas)
Intl.RelativeTimeFormat escreve as palavras; você escolhe a unidade. Este helper escolhe a maior unidade que couber.
Intervalos de datas
formatRange remove as partes repetidas, então uma reserva do dia 5 ao dia 9 do mesmo mês fica natural de ler.
Layouts personalizados com formatToParts
Quando nenhum padrão serve, pegue as partes localizadas e organize-as você mesmo, por exemplo para deixar o dia maior que o mês.
Trabalhando com segundos desde a epoch? Use o
conversor de Unix timestamp
Opções de Intl.DateTimeFormat usadas no gerador
- Opção
- Valores
(nenhum)
(seu fuso)
Erro: {msg}
Gerador de Intl.DateTimeFormat
Data e hora
Locale
Fuso horário
Modo
Estilos predefinidos
Escolher cada parte
Copiar código
Comece o teste grátis · Teste grátis de 7 dias, $0 hoje
Relacionados: Guias
- Event listeners em JavaScript
- localStorage em JavaScript (com exemplos práticos)
- O for no JavaScript, e qual loop usar em cada caso
- Objetos em JavaScript e por que aparece [object Object]
- Recarregar a página com JavaScript
- Rolar até um elemento com JavaScript
- Ordenar um array de objetos em JavaScript
- Métodos de string em JavaScript
Produto
Para quem é
- Para agências
- Para freelancers
- Para provedores de hospedagem
- Para plataformas SaaS
- Para startups
- Serviços financeiros
- Soluções para saúde
Recursos
Recursos
- Blog
- Central de Ajuda
- Ferramentas gratuitas para empresas
- Free UI Components
- Modelos
- Coleções de modelos
- Exemplos de sites
- Guias
- Comparações
- Alternativas
- Os melhores
- Avaliações
- Guias de preços
- Casos de uso
- Glossário e guias
- Integrações
- Desenvolvedores
- Benchmark
- Windows App