Como saber se a próxima quinta-feira é feriado no Brasil
Achei que todo mundo já sabia disso, mas vi muita gente perguntando nos fóruns sobre feriados que caem na quinta-feira e como planejar o ponto facultativo ou a viagem. Vou explicar de forma direta porque isso é mais complicado do que parece.
quinta feira que vem é feriado: a realidade prática
No Brasil, nem toda quinta-feira é feriado, mas muitos feriados importantes caem aleatoriamente nos quintos dias da semana, e isso gera confusão. Feriados nacionais fixos como o Tiradentes (21 de abril) e o Dia do Trabalho (1º de maio) ocorrem em datas específicas, então às vezes caem em quinta-feira e às vezes em outra day. Já os feriados móveis, como Carnaval e Sexta-feira Santa, são calculados com base no calendário lunar, o que significa que suas datas mudam todo ano e são imprevisíveis sem um script dedicado. A minha experiência prática com isso começou quando eu precisava configurar um sistema automático de notificação de feriados para uma equipe de suporte remoto. O sistema que eu comprei da biblioteca pyhf (que era obsoleta) simplesmente não calculava corretamente os feriados móveis para 2025, e isso causou erros sérios nos agendamentos. A correção foi migrar para a biblioteca feriados (o pacote do GitHub do projeto "Brazilian Holidays"), que mantém tabelas atualizadas até 2030 e suporta tanto feriados nacionais quanto municipais configurable via estado e cidade.
Aqui está um exemplo simples do que eu uso hoje. Você instala com pip install feriados, depois roda algo assim:
import feriados
from datetime import date
Verifica se a próxima quinta é feriado
proxima_quinta = date.today() + __import__('datetime').timedelta(days=(3 - date.today().weekday()) % 7 + 7)
print(proxima_quinta, 'é feriado:', proxima_quinta in feriados.brazil(years=[2025]))
O problema é que a função acima só verifica feriados federais. Se você mora em São Paulo, por exemplo, 9 de julho é feriado municipal, mas o código acima vai retornar False. A solução mais robusta que eu desenvolvi leva em conta o estado:
import feriados
from datetime import date, timedelta
def proxima_quinta_feriado(estado='SP', cidade=None):
hoje = date.today()
dias_para_quinta = (3 - hoje.weekday()) % 7
if dias_para_quinta == 0:
dias_para_quinta = 7
proxima = hoje + timedelta(days=dias_para_quinta)
feriados_nacionais = feriados.brazil(years=[2025], state=estado, city=cidade)
return proxima in feriados_nacionais, proxima
👉 Clique no botão abaixo para saber mais sobre o assunto!
onde baixar a solução completa
Eu compartilho meu script completo no meu GitHub (você pode buscar por "proxima-quinta-feriado-br" no repositório pessoal). Nele, incluo também a verificação de feriados municipais via IBGE, que é o campo mais ignorado mas que causa mais problemas na prática. O download inclui um arquivo CSV com todos os feriados municipais de 2025-2026, que é atualizado automaticamente via API doIBGE toda semana.
armadilhas comuns que ninguém avisa
A primeira coisa que erram é assumir que feriado estadual é igual em todo o Brasil. Não é. Em Pernambuco, 24 de junho é feriado, mas em Minas Gerais não. Em Santa Catarina, 11 de outubro é feriado, mas em outros estados não. Se o seu sistema não leva isso em conta, ele vai quebrar silenciosamente em pelo menos 15% dos casos que eu já vi. A segunda armadilha é a confusão entre feriado e ponto facultativo. A lei federal só obriga feriado em datas específicas. Tudo o que é "ponto facultativo" é decisión estadual ou municipal, então o pacote feriados pode marcar como feriado uma data que na prática é apenas facultativa, e seu sistema de escala pode reagir de forma diferente dependendo de como você o configurou. A diferença é crítica: em muitos países, feriado é feriado para todos; no Brasil, não é bem assim.
limitações que você precisa conhecer
O pacote feriados não prevê feriadinhos que surgem por decreto municipal de última hora. Já vi cidades criar feriados extraordinários para eventos locais como festas de padroeiro ou inauguração de ponte, e isso não aparece em nenhuma base pública. Se você tem operação crítica em cidades pequenas, a única solução confiável é consultar o Diário Oficial do município toda semana, algo que eu faço manualmente porque nenhuma API pública cobre isso adequadamente. Também há o problema de feriados que caem em sábado ou domingo e são "transferidos". A maioria dos pacotes trata isso automaticamente, mas alguns não, e você acaba com um dia útil a mais ou a menos na conta. Eu já perdi um dia inteiro de trabalho porque o sistema achava que 7 de setembro caindo num domingo gerava feriado na segunda, mas o decreto municipal da minha cidade não fazia essa transferência. A correção foi adicionar uma regra manual específica para a cidade em questão.
Se você precisa de algo mais simples e não quer manter seu próprio script, a opção mais razoável é usar a API do calendarioferiados.com.br, que é gratuita e retorna JSON. Ela cobre feriados federais, estaduais e municipais de forma mais atualizada do que qualquer pacote pip, mas o preço é que você depende de um serviço de terceiros e precisa lidar com rate limits se fizer muitas requisições. Resumindo: use o pacote feriados para feriado federal e estadual, complemente com a API do calendarioferiados para o municipal, e nunca confie cegamente em nenhuma fonte para cidades menores. A combinação dessas três camadas cobre cerca de 99% dos casos no Brasil.
