Como saber o feriado do dia seguinte sem perder tempo
A coisa mais comum é você acordar, pegar o celular e querer saber se amanhã tem feriado. A resposta não está em um aplicativo bonito, mas em uma base de dados que ninguém mantém organizada. Eu passava horas cruzando planilhas antigas até descobrir que a solução mais rápida é quase sempre manual. O processo consiste em pegar a data, identificar o mês e o tipo de feriado (nacional, estadual ou municipal), e então verificar a tabela oficial do ano correspondente. Simples, mas com pegadinhas que você só leva na prática.
O que é e como usar a ferramenta que feriado é amanha
Eu costumava usar um script simples que consultava o calendário oficial do governo federal e estadual. Funcionava bem, até o dia em que meu código começou a falhar em anos bissextos e feriados móveis, como Páscoa e Carnaval. A falha era sutil: ele retornava uma data errada porque não considerava a regra de cálculo do feriado religioso. Aprendi na marra que a melhor abordagem é ter uma tabela fixa com os feriados nacionais e estaduais pré-calculados para pelo menos cinco anos à frente, e usar uma biblioteca de cálculo de data apenas para os móveis.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Passo a passo prático
Primeiro, defina o escopo. Você precisa dos feriados nacionais, dos estaduais da sua região ou dos municipais? Isso muda tudo. No meu caso, eu precisava dos estaduais de São Paulo e Rio de Janeiro, então criei uma planilha CSV com as datas fixas para cada ano. Depois, usei a função `dateutil.easter` do Python para calcular Páscoa e derivei a Sexta-Feira Santa e Corpus Christi. Para o Natal e Consciência Negra, são datas fixas. O resultado foi um arquivo JSON que eu consultava localmente, evitando requisições de API que caem quando você mais precisa. Um erro comum é confiar apenas em APIs públicas. Elas têm limite de requisição e podem sair do ar. No meu trabalho, uma vez a API do governo federal ficou fora do ar no feriado de Tiradentes, e eu não sabia se era feriado ou não para um relógio de ponto eletrônico. A solução foi fazer um fallback para o arquivo local, que eu atualizava manualmente todo ano. Custou cerca de 30 minutos anuais, mas evitou horas de troubleshooting.
Dica técnica contra-intuitiva
Muita gente acha que basta verificar se a data é domingo. Feriados nacionais no Brasil incluem dias fixos e dias móveis. Os fixos são facilmente listados, mas os móveis dependem do ano. Um insight que ganhei foi: em vez de calcular dinamicamente, use uma tabela prévia para os próximos 10 anos. Isso elimina a complexidade do cálculo e reduz o risco de erro para zero, desde que você atualize a tabela todo ano. O tempo de manutenção é baixo, e a confiabilidade é alta. Também é importante notar que alguns estados e municípios têm feriados próprios que não são nacionais. Se você desenvolve um sistema para todo o país, precisa de uma lista completa por unidade federativa. No meu caso, eu mantinha um dicionário aninhado onde a chave era o estado e o valor era uma lista de tuplas (dia, mês, nome). A atualização era rápida, mas exigia atenção aos decretos estaduais.
Limitações e quando não usar
Essa abordagem não funciona bem se você precisa de atualizações em tempo real, como alterações de feriado por lei no último minuto. Nesses casos, uma API é mais segura, mas você deve implementar retry e cache. Além disso, se o seu público for nacional, a quantidade de feriados estaduais e municipais pode ser enorme, e manter tudo atualizado é inviável. Minha recomendação é usar uma fonte confiável, como o calendário da Receita Federal, e fazer uma tradução manual para as datas móveis. Isso exige um investimento inicial, mas paga-se em estabilidade. Se você está começando, comece com o básico: feriados nacionais fixos e móveis calculados por uma biblioteca. Vá evoluindo conforme a necessidade. Não tente embutir toda a complexidade logo de cara, ou você vai passar mais tempo mantendo do que usando.
