O calendário civil brasileiro e as armadilhas que ninguém comenta
O calendário usado no Brasil é o gregoriano, adotado oficialmente em 15 de novembro de 1889, logo após a proclamação da república. Três questões simples complicam muito a vida de quem trabalha com sistemas, folha de pagamento ou agendamentos: feriados variáveis, ferados estaduais e municipais, e a forma como a Microsoft e a Oracle lidam (ou não lidam) com eles em conjunto.
Como funciona o calendário usado no brasil na prática
Um ano tem 12 meses. Dias úteis descontam sábados, domingos e feriados. O Brasil soma feriados nacionais fixos, feriados móveis como Carnaval e Corpus Christi, e ainda tem mais de 5.500 municípios com seus próprios feriados. Isso significa que um sistema que usa apenas o padrão do pacote.office vai errar feriados em qualquer cidade que não seja sede de estado. Já vi planilhas de RH considerando que todo funcionário tem apenas os feriados federais, o que gera conflito trabalhista quando o operário de uma cidade do interior entra no ponto num feriado municipal que a matriz desconhecia. Os feriados móveis seguem o cálculo da Páscoa. A regra padrão é a fórmula de Meeus-Jones-Butcher. Ela devolve um número exato; a partir daí, Carnal vale D-49 dias, Sexta-feira Santa D-2, Corpus Christi D+60. Quem tenta calcular isso na unha erra em pelo menos um dia a cada ciclo de quatro anos. Use uma biblioteca, não uma conta no Excel.
Configuração técnica em ambientes corporativos
No Windows, o identificador de calendário do Brasil é pt-BR. O formato de data cur to é dd/MM/yyyy. O primeiro dia da semana, conforme a definição regional, é domingo. No SQL Server, o set datefirst define qual dia começa a semana para suas consultas; em São Paulo, costuma-se usar 7 para domingo, mas muitos scripts herdam configuração padrão do servidor que pode ser segunda. Isso quebra filtros de férias e escalas quando você sobe o banco para outra máquina. No Google Calendar, o calendário do Brasil está disponível como Holidays/BR. Ele cobre feriados federais e alguns municipais notórios, mas falha em listar feriados de cidades menores. Para uso interno de uma empresa com filiais espalhadas, convém criar um calendário personalizado e importar uma lista XML com os feriados de cada município relevante.
Fontes confiáveis para listas de feriados
A melhor fonte primária é a lei 10.607/2002 para os feriados nacionais fixos, atualizada por leis estaduais e decretos municipais. Para automação, o pacote python holidays do Ferdi Maddalão é o mais prático: ele consulta dados consolidados e já traz os feriados estaduais e municipais por uf. Se você não usa Python, a aba de feriados do site do Tribunal Superior Eleitoral serve de conferência cruzada, porque as eleições sempre geram pontuais instruções regionais de expediente. Outra alternativa é consumir a API do calendarific ou do working-days.io, que oferecem planos gratuitos com feriados do Brasil. A desvantagem é que a cobertura municipal varia conforme o provedor, então valide contra o diário oficial da sua cidade antes de confiar cegamente.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Pegadinhas que custaram horas do meu tempo
No final de 2022, precisei ajustar um sistema de escala hospitalar que considerava apenas feriados federais. O hospital estava em Santos, SP. Eles têm feriado municipal em 23 de setembro, Dia de Nossa Senhora do Monte Serrat. Nenhum funcionário entrou naquele dia, mas a escala automática gerou escala normal porque a lista de feriados do padrão pt-BR não incluía Santos. O resultado foi um sindicato movendo reclamação e eu tendo que refazer toda a escala do mês. A correção foi adicionar um feed municipal específico para a cidade e substituir o feed federal genérico por esse feed localizado. Aprendi que a abreviação pt-BR sozinha não é suficiente para escala de saúde, transporte ou indústria. Outro problema recorrente é o tratamento de feriados que caem no domingo. A lei federal determina que, quando um feriado nacional cai no domingo, ocorre compensação na segunda-feira. Alguns sistemas aplicam essa compensação automaticamente, outros não. Em contratos de terceirização com a prefeitura, a falta dessa regra gera diferença de pagamento entre o orçamento estimado e o real.
Feriados móveis: como calcular sem erro
A Páscoa se calcula pela regra do equinócio da primavera no hemisfério sul. A conta é: encontrar a lua cheia eclesiástica após 21 de março e depois o próximo domingo. Em termos práticos, use a função EASTER do Google Sheets ou a função datenum combinada com a lógica de epacta no Excel. Se você estiver em Python, basta chamar holidays.Brazil(include_christmas_eve=False, subdiv="SP"). O parâmetro subdiv é o que diferencia o feriado estadual. Sem ele, o pacote retorna apenas o federal. Há um detalhe que poucas pessoas levam em conta: feriado móvel pode cair em sábado. Nesses casos, não há compensação obrigatória para segunda. O ponto fica normal no sábado e a segunda também. Quem programa escalas achando que toda festa móvel gera ponto extra cria buracos na folha.
Limitações e alternativas honestas
O calendário gregoriano brasileiro é estável. O problema não é o calendário em si, é a camada de feriados que varia por ente federativo e por município. Nenhuma solução única cobre tudo com 100% de assertividade. Sistemas prontos de RH, como Totvs e SAP, têm bases de feriados atualizadas, mas a atualização depende do contrato de suporte. Se o contrato estiver vencido, você fica com uma base parada. Para projetos pequenos ou médios, a solução mais barata e confiável é manter duas fontes: uma para feriados federais e estaduais (holidays ou base interna do governo) e uma para municipais (extraída dos diários oficiais de cada cidade onde há unidade operacional). Rodar um job mensal que cruza as duas listas evita surpresas no próximo mês.
Passo a passo rápido para montar sua tabela de feriados
Comece gerando a lista federal com holidays.Brazil(years=[2025,2026]). Depois, adicione os estaduais consultando os sites das secretarias de cada estado ou usando a subdiv do próprio pacote. Em seguida, pegue os decretos municipais no site da prefeitura ou no diário oficial. Importe tudo para uma tabela única com colunas data, tipo, codigo_municipio e observacao. Mantenha uma coluna booleana para indicar se o feriado foi compensado. Teste contra o ponto real dos funcionários antes de colocar em produção. Se você precisa de um arquivo pronto para importar no Excel, o link direto para a planilha de feriados do governo federal está em.gov.br/calendario. Para estados e municípios, acesse os portais das respectivas secretarias. Não existe um repositório único que consolide tudo com qualidade aceita para uso jurídico.
Erros comuns que dão prejuízo
O erro mais frequente é assumir que pt-BR no software equivale a Brasil completo. Ele equivale ao formato regional, não à base de feriados locais. Outro erro é ignorar o feriado municipal de cidades que recebem verbas federais ou sediam hospitais de referência; esses municípios costumam ter mais feriados do que a média. Um terceiro erro é tratar o Dia da Consciência Negra, 20 de novembro, como feriado nacional. Ele é feriado nacional apenas a partir de 2024, por lei, mas antes disso só era reconhecido em estados e municípios específicos. Sistemas antigos que marcam 20 de novembro como feriado antes de 2024 estão errados para o período anterior. O calendário usado no brasil, então, é mais do que escolher um idioma regional. É entender que a base de feriados é fragmentada, que feriados móveis exigem cálculo astronômico, e que nenhuma configuração automática substitui a validação municipal quando o impacto é trabalhista ou financeiro.
