Como saber qual feriado de hoje com precisão
Você provavelmente já caiu na armadilha de consultar uma única fonte e descobrir que o feriado estava errado, ou que a regra que funcionava no ano anterior tinha sido alterada. Isso acontece frequentemente quando se trata de qual feriado de hoje, porque o Brasil, Portugal e outros países lusófonos têm regras festivas diferentes e sobrepostas, além de feriados municipais que cada cidade decide por conta própria.
qual feriado de hoje: métodos práticos
A forma mais confiável que encontrei envolve duas camadas. Primeiro, você precisa saber qual é a base oficial para feriados federais, estaduais e municipais. Depois, precisa cruzar com a tabela de datas móveis, que dependem do calendário eclesiástico e mudam todo ano. O Feriados.com.br mantém uma tabela consolidada, mas o problema é que muitas pessoas copiam os dados sem checar exceções municipais. Já o calendário da Secretaria da Fazenda tem as regras fiscais, que muitas vezes não coincidem com o calendário civil. Eu aprendi isso na prática quando precisei emitir uma NF-e e o dia foi declarado feriado em uma plataforma mas não na outra. O systema da SEFAZ SP simplesmente recusou a nota, enquanto a consulta em outro estado dizia que estava tudo normal. A solução foi consultar o Diário Oficial do município diretamente, pegando a lei municipal que declara o feriado local. Leva cerca de dois minutos, mas evita dor de cabeça.
Para quem precisa de automação, existem APIs como a da Calendarific, mas ela cobre apenas feriados federais e nacionais. Feriados estaduais e municipais ficam de fora. Se o seu sistema depende disso, você vai ter que manter uma tabela própria de exceções. Isso é trabalhoso, mas necessário.
👉 Clique no botão abaixo para saber mais sobre o assunto!
como lidar com feriados móveis
Carnaval, Páscoa, Corpus Christi e outras datas móveis são onde a maioria dos erros acontece. Elas seguem uma regra fixa baseada na lua, mas nem todo mundo sabe calcular. A fórmula de Gould funciona, mas é mais simples usar uma biblioteca pronta. Em Python, o pacote ptbr ou holidays do Brazil resolve isso rapidamente. No entanto, mesmo essas bibliotecas têm lacunas: alguns municípios têm feriados móveis próprios que não aparecem em nenhuma base pública. Uma limitação importante que poucas pessoas mencionam: feriados estaduais costumam variar de acordo com a padroeira de cada estado. São Paulo tem São Paulo em 9 de julho como feriado estadual. Rio de Janeiro tem o nosso Senhora Aparecida em 12 de outubro. Minas Gerais tem a sua própria lista. Se você estiver desenvolvendo um sistema nacional, precisa ter uma tabela de feriados estaduais por UF, e não apenas federal.
o problema dos feriados municipais
Este é o ponto mais crítico e o que mais gera transtorno. Cada município Decide se declara feriado, e não há uma base nacional unificada. Existem leis municipais publicadas em diários oficiais que são esquecidas ou não atualizadas em sites de terceiros. Minha recomendação prática é manter uma planilha de feriados municipais mapeados por código IBGE, atualizada a cada ano com base nas leis mais recentes. Para grandes cidades como São Paulo, Rio de Janeiro e Brasília, a informação costuma estar disponível nos sites das prefeituras. Para cidades menores, muitas vezes é necessário entrar em contato direto com a prefeitura ou verificar o diário oficial impresso. Se o seu negócio opera em mais de mil municípios, considere contratar um serviço especializado como o Caged Férias ou o Feriados.com.br PRO, que já mantém essa base atualizada e cobra por assinatura. Vale o custo se você processa folgas funcionais ou calcula pontos facultativos.
quando a informação falha
Nenhuma fonte é 100% confiável o tempo todo. Anos de recesso eleitoral, por exemplo, geram confusão porque algumas cidades declararam feriado extra por lei complementar e outros não. A melhor prática é sempre cruzar pelo menos duas fontes antes de tomar uma decisão que envolva prazos legais ou financeiros. A pergunta qual feriado de hoje parece simples, mas a resposta depende de onde você está, de qual esfera de governo considera válida e de quão recente é a fonte que você consultou. Manter o controle disso faz diferença no dia a dia, principalmente quando o prazo aperta.