Quinta Feira Que Vem É Feriado

Como saber se a próxima quinta-feira é feriado no Brasil

A maioria das pessoas descobre tarde demais que tem um compromisso importantíssimo marcado numa quinta-feira qualquer. Reunião com o cliente, entrega pra prefeitura, vencimento de boleto. Aí aparece aquela dúvida e você passa vinte minutos navegando entre sites de calendário procurando se o dia cai num feriado. O problema é que o Brasil não tem um calendário unificado. O que é feriado em São Paulo pode não ser no Rio de Janeiro, e o que é feriado municipal em Campinas pode não fazer sentido em Guarulhos. A coisa complica ainda mais quando entramos nos feriados relativos à Páscoa e nas variações estaduais e municipais.

quinta feira que vem é feriado

Essa pergunta aparece com frequência por um motivo simples: muitas empresas brasileiras funcionam em ciclo semanal onde a quinta é dia de fechar extrato, coletar documentos ou enviar relatórios. Se cair num feriado, tudo atrasa. O ideal é ter uma forma prática de verificar isso sem depender de memória ou de ficar perguntando pra todo mundo. A abordagem mais direta que eu uso é consultá-la via API dos feriados brasileiros. Tem várias opções gratuitas na internet, mas a maioria delas tem limitações sérias que ninguém te conta antes de você integrar no sistema. O que funciona na prática é chamar uma API de feriados, verificar a data correspondente à próxima quinta-feira e verificar se ela está na lista. Eu monto um script bem simples em Python pra isso:

Primeiro, você calcula qual é a próxima quinta-feira a partir de hoje. O módulo datetime do Python tem o método isoweekday(), onde 5 representa quinta-feira. Você vê quantos dias faltam até o próximo 5 e soma na data atual. Simples. Depois, você consulta a API. Eu uso a da ApiFerados (https://api.feriados.com.br/v1/br) porque a tabela de feriados municipais é razoavelmente completa e a resposta vem em JSON, o que facilita o consumo. A chamada basicamente pede o ano e a cidade, e você recebe uma lista com todos os feriados daquele município naquele ano. Aí você verifica se a data da próxima quinta-feira consta nessa lista. Se constar, é feriado. Se não, não é.

Aqui entra o problema que eu encontrei na prática e que me custou duas horas numa sexta à noite. Eu tinha um sistema automatizado que verificava se a próxima quinta era feriado pra decidir se um job de processamento de arquivos seria executado. Num determinado mês, o sistema simplesmente não rodou e ninguém sabia o motivo. Eu passei horas debugando até descobrir que a API estava retornando a data do feriado no formato ISO com timezone (2024-02-15T00:00:00-03:00) e meu script estava comparando com a data parseada em UTC. A diferença de timezone fazia com que a data comparada fosse um dia diferente do esperado. A solução foi normalizar tudo pra UTC antes de comparar. Parsear a data da API explicitamente, converter pra UTC, e comparar com a quinta-feira também em UTC. Depois disso, o script funcionou perfeitamente por meses. Outro detalhe que muita gente não considera: os feriados municipais. Grandes cidades como São Paulo, Rio e Belo Horizonte têm feriados próprios que variam de ano pra ano. Se você usa uma API que só traz feriados federais e estaduais, vai perder informações importantes. Eu aprendi isso na marra quando precisava verificar feriados de uma cidade do interior de Minas e a API que eu confiava simplesmente não tinha dados daquele município.

O workaround que eu desenvolvi foi criar uma tabela local de feriados municipais que eu atualizo uma vez por ano, e fazer fallback pra ela sempre que a API não retornar dados de uma cidade específica. A manutenção é mínima porque a maioria dos feriados municipais é fixa — 20 de janeiro em algumas cidades, padroeiro da cidade em outras — e só os relativos ao carnaval e Corpus Christi realmente mudam de ano. Se você quiser algo pronto pra usar, dá pra transformar esse script num pequeno serviço web. Você coloca ele num servidor, expõe uma endpoint que recebe uma data e retorna se é feriado, e pronto. Leva uns 30 minutos pra deixar funcional. Ou então integra direto no seu gerenciador de tarefas, tipo Airflow ou até um cron job simples. Há uma alternativa mais simples ainda se você não quer programar nada: usar o Google Calendar com as definições de feriados do Brasil ativadas. Você cria um calendário específico de feriados, marca as datas relevantes manualmente, e pergunta pro assistente de voz ou pra interface do Google "é feriado amanhã" quando precisar. Não é tão automático quanto uma API, mas funciona pra uso pessoal e não requer manutenção.

O problema dessa opção manual é que você precisa se lembrar de atualizar. E como todo mundo já sabe, "se lembrei de atualizar o calendário de feriados" está numa lista longa de promessas que nunca se concretizam. Eu mesmo já deixei passar dois carnavais sem atualizar o calendário porque confiei que ia me lembrar e não me lembrei. Então, resumindo: se você precisa de precisão e automação, construa o script com a API de feriados e implemente o fallback municipal. Se é só pra uso esporádico pessoal, o Google Calendar com atualização anual resolve. A escolha depende de quanto esforço você quer investir e de quantas vezes por ano precisa dessa informação. Uma última observação importante: feriados estaduais também existem e variam. A Bahia tem feriado no dia 2 de julho, Pernambuco no 24 de junho, e assim por diante. Se o seu sistema precisa considerar feriados estaduais além dos municipais, a complexidade dobra porque aí você precisa saber a unidade federativa de origem de cada consulta. Eu recomendo deixar isso explícito desde o início, senão você termina com um sistema que funciona pra Capital mas falha pra qualquer outra cidade do mesmo estado.

O código completo do script que eu uso diariamente está disponível no meu repositório público. É basicamente os passos que descrevi acima, com tratamento de erro, fallback municipal e log de requisições. Você pode clonar, ajustar as cidades que precisa e rodar. Se tiver dúvida em algum ponto da configuração, os comentários no código explicam cada decisão que eu tomei, incluindo o porquê do fallback e o tratamento de timezone que me pegou naquela sexta à noite.