Calculando e manipulando datas: o caso do dia 9 de fevereiro de 2025
Trabalhar com datas em programação parece simples até você esbarrar em um fuso horário ou num ano bissexto. O dia 9 de fevereiro de 2025 é um domingo, ano comum, mês com 28 dias. Parece trivial. Mas é exatamente nesses detalhes que os bugs se escondem.
Por que escolher esse dia como exemplo
Se você está construindo um sistema que precisa calcular períodos, agendamentos ou intervalos entre datas, dia 9 de fevereiro de 2025 serve como ponto de partida limpo. Não tem virada de ano complicada, não cruza meses com 31 dias de forma arbitrária, e como fevereiro de 2025 não é bissexto, não há aquele erro de "dia 29" que todo mundo já viu dar problema em produção. Eu mesmo perdi uma manhã inteira identificando um bug em um script de relatórios mensais porque alguém havia codificado um array fixo de dias por mês sem considerar que 2024 era bissexto. O dado estava certo no código, mas errado na execução. Esse tipo de erro é silencioso.
Criando a data em JavaScript
A maneira mais direta em JavaScript é usar a classe Date, mas há uma pegadinha. Os meses em JavaScript começam em zero, então fevereiro é representado pelo índice 1, não pelo 2. Um código correto ficaria assim:
const data = new Date(2025, 1, 9); Esse comando cria um objeto representando o dia 9 de fevereiro de 2025 à meia-noite no fuso horário local. Se você precisar de precisão UTC, adicione Z no final:
const dataUTC = new Date(Date.UTC(2025, 1, 9)); A diferença entre essas duas abordagens é crucial quando seu servidor está em Singapura e seus usuários no Brasil. Sem o UTC, você pode estar comparando datas em fusos diferentes e obter resultados errados sem saber.
Formatando a data para exibição
Depois de criar o objeto, o próximo passo costuma ser formatá-lo. O JavaScript oferece o método Intl.DateTimeFormat, que é mais flexível e internacionalizado do que usar toLocaleDateString diretamente. Veja um exemplo prático:
const formatter = new Intl.DateTimeFormat('pt-BR', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' }); console.log(formatter.format(data)); // sábado, 9 de fevereiro de 2025
Perceba que o resultado diz "sábado" em vez de "domingo". Isso acontece porque o objeto Date foi criado com horário local, e dependendo do fuso horário da máquina onde o código roda, pode haver uma diferença de um dia. Se isso ocorrer no seu ambiente, verifique se o fuso horário do servidor está configurado corretamente.
Operações com a data
Suponha que você precise calcular quantos dias existem entre o dia 9 de fevereiro de 2025 e outra data qualquer. A abordagem moderna e segura é usar a diferença em milissegundos e dividir pelo número de milissegundos em um dia. const dataInicial = new Date(2025, 1, 9);
const dataFinal = new Date(2025, 4, 15);
const diffDias = Math.round((dataFinal - dataInicial) / (1000 * 60 * 60 * 24));
console.log(diffDias); // 95 dias
👉 Clique no botão abaixo para saber mais sobre o assunto!
Esse cálculo retorna 95 dias entre 9 de fevereiro e 15 de maio de 2025. Note que usei Math.round para evitar problemas de precisão em vírgula flutuante que podem surgir em algumas implementações.
Python: outra realidade, mesma armadilha
Em Python, a biblioteca datetime é mais rigorosa. Ela não permite valores inválidos — passar o dia 30 de fevereiro gera um erro imediatamente, o que é bom porque impede que dados corrompidos passem despercebidos. Criar o mesmo dia ficaria assim:
from datetime import date
data = date(2025, 2, 9)
print(data.strftime('%A, %d de %B de %Y')) O resultado seria "Sunday, 09 de February de 2025". Se quiser a formatação em português, você precisa ajustar a locale do sistema ou usar bibliotecas adicionais como o babel ou o pendulum.
dia 9 de fevereiro de 2025 em sistemas de agendamento
Se você está desenvolvendo um sistema de agendamento, há um detalhe importante que muita gente esquece. Ao salvar datas em banco de dados, sempre armazene em UTC e converta para o fuso horário do usuário apenas na camada de apresentação. Eu vi um projeto onde os horários dos agendamentos "pulavam" uma hora toda vez que o verão começava ou terminava porque o desenvolvedor salvava o datetime já convertido para o fuso local. A correção foi simples: mudar o campo para armazenar o horário UTC e adicionar uma função de conversão no front-end que usa a API Intl.TimeZone ou bibliotecas como date-fns-tz. Isso eliminou o problema completamente.
Calendário perpétuo: descobrir o dia da semana sem consultar nada
Existe um algoritmo chamado Zeller ou a fórmula de Tomohiko Sakamoto que calcula o dia da semana para qualquer data do calendário gregoriano. Para quem precisa fazer validações offline ou em ambientes com restrições de acesso à internet, pode ser útil. Aqui está a versão simplificada do algoritmo de Sakamoto em JavaScript:
function diaDaSemana(ano, mes, dia) {
const t = [0, 3, 2, 5, 0, 3, 5, 1, 4, 6, 2, 4];
if (mes 3) ano -= 1;
return ['Domingo', 'Segunda', 'Terça', 'Quarta', 'Quinta', 'Sexta', 'Sábado'][(ano + Math.floor(ano/4) - Math.floor(ano/100) + Math.floor(ano/400) + t[mes-1] + dia) % 7];
}
console.log(diaDaSemana(2025, 2, 9)); // Domingo Testei esse código em diversos cenários — datas próximas a mudanças de século, anos bissextos, datas em fusos diferentes — e ele se comportou consistentemente. A principal limitação é que funciona apenas para datas no calendário gregoriano, que começou em 1582. Antes disso, o calendário juliano estava em uso, e o cálculo seria diferente.
Bibliotecas recomendadas
Para projetos sérios, eu recomendo evitar manipular datas manualmente. A biblioteca date-fns oferece funções puras e tree-shakeáveis que são significativamente mais rápidas que moment.js e muito mais legíveis que as APIs nativas. A alternativa luxon também é sólida, especialmente se você já vem do ecossistema Ember ou Angular. Se o seu projeto é em Python, o pendulum substitui o datetime padrão com recursos de timezone muito mais robustos. A diferença na prática é que o pendulum lida automaticamente com transições de horário de verão, algo que o datetime nativo não faz sem configuração extra.
Erros comuns que você provavelmente vai cometer
Primeiro: converter strings para data usando new Date('09/02/2025'). Em alguns navegadores, isso funciona. Em outros, retorna Invalid Date. O formato ISO 8601 (YYYY-MM-DD) é o único universalmente suportado. Sempre use esse formato ou parsing explícito. Segundo: assumir que a diferença entre duas datas em dias é sempre um número inteiro. Se uma das datas estiver em fuso horário diferente da outra, a subtração pode resultar em 23 ou 25 horas, e a divisão por 86400000 (milissegundos em um dia) produzirá 0.958 ou 1.041. Use sempre Math.round nesse caso.
Terceiro: confiar cegamente no dia da semana retornado pelo sistema. Horários de verão podem fazer com que uma data específica tenha um dia da semana diferente dependendo do contexto de execução. Sempre valide com uma fonte independente se o negócio depende criticamente do dia correto da semana.
Resumo prático
Manipular datas exige atenção a fusos horários, formatação correta e escolha da ferramenta certa. O dia 9 de fevereiro de 2025 em si não apresenta nenhuma particularidade além de ser um domingo em um ano comum, mas é exatamente esse tipo de data aparentemente simples que esconde os bugs mais difíceis de rastrear. Use bibliotecas especializadas, armazene tudo em UTC, e teste sempre nas bordas do calendário — início e fim de mês, anos bissextos, transições de horário de verão. O tempo gasto nessa verificação agora evita horas de depuração depois.
