Calendário Usado No Brasil

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. 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.

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.