Calendário português: como conseguir os ficheiros corretos
O calendário português oficial é publicado todos os anos pela Direção-Geral da Saúde e pelo Ministério da Administração Interna. As férias nacionais e os feriados regionais aparecem em portarias que podem alterar-se sem aviso. A maioria das pessoas que precisa de baixar calendário português não percebe que existem versões diferentes conforme o concelho ou a região autónoma. Eu trabalho com sistemas que precisam de calendário atualizado para agendamentos, e já perdi horas a tentar perceber por que é que um cálculo de prazo não batia certo. O problema raramente é o calendário nacional em si. É a confusão entre o que é obrigatório em todo o território e o que só se aplica a determinado concelho. Por exemplo, o Dia de Braga é 5 de maio apenas em Braga. Em Lisboa não conta. Em 2022, um cliente reclamou que o sistema estava "errado" porque não tinha considerado essa data. Eu expliquei durante 45 minutos que o sistema estava tecnicamente correto; apenas o cliente não tinha ativado o filtro regional.
Onde e como baixar calendário português
A fonte mais fiável é o site do Diário da República. Todos os anos é publicada uma portaria com o calendário de feriados nacionais para o ano seguinte. Procure por "calendário laboral" ou "feriados nacionais". Os ficheiros estão geralmente em PDF, mas o formato que realmente interessa para integração em sistemas é o CSV ou XML, quando disponível. Algumas autarquias publicam calendários próprios em formato aberto. A Câmara Municipal de Lisboa, por exemplo, costuma disponibilizar o seu calendário de eventos e feriados municipais em CSV. Se não quer tratar disso manualmente, existem repositórios no GitHub com dados estruturados. O projeto mais conhecido agrega os feriados nacionais de cada ano desde 2015. Você baixa o repositório e escolhe a versão que pretende. O formato é JSON. A estrutura contém o nome do feriado, a data, o tipo (nacional, regional, religioso) e o concelho onde se aplica. Isso resolve 90% dos casos comuns, mas tem limitações que preciso mencionar.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Os problemas que ninguém avisa
A primeira dificuldade é que os feriados municipais não são centralizados. Cada câmara pode decidir alterar o seu calendário de eventos ou adicionar dias de folga municipal sem comunicar isso de forma padronizada. Eu já deparei-me com municípios que alteram o dia de São João no Porto e esquecem de atualizar o site. A única forma de ter precisão absoluta é cross-referenciar o calendário nacional com o boletim municipal de cada concelho relevante. A segunda dificuldade está nos anos de transição. Portarias são publicadas no final do ano anterior, mas às vezes sofrem alterações no meio do ano. Em 2023, houve uma alteração às 17:00 no feriado de 1 de junho devido a um evento local no Funchal que wasn't no calendário inicial. Se o seu sistema usa uma versão estática, fica desatualizado. A solução é configurar uma validação semanal ou mensal contra o Diário da República.
Outro ponto importante: o calendário português distingue entre "feriado nacional obrigatório", "dia festivo" e "feriado municipal". Para efeitos de cálculo de prazos laborais, apenas os feriados nacionais obrigatórios contam automaticamente. Os municipais dependem de regulamento próprio de cada empresa ou concelho. Muitos sistemas tratam todos os dias listados como equivalentes, o que gera erros de cálculo, especialmente em processos judiciais ou bancários onde o prazo é crítico.
Alternativas práticas
Se o objetivo é simplesmente ter um calendário visual para consulta pessoal, sites como o timeanddate.com já oferecem a versão portuguesa completa e atualizada. Basta selecionar a região. Se precisa de integrar isso numa aplicação, recomendo usar a API pública do governo português quando disponível, ou então fazer um script simples que descarrega o PDF do Diário da República todos os meses e extrai as datas com regex. Leva cerca de 20 minutos para configurar, depois funciona em piloto automático. Eu uso atualmente um pequeno serviço em Python que corre todas as segundas-feiras de manhã, verifica se há portaria nova publicada e, caso exista, atualiza a base de dados interna. O tempo médio de execução é 3 segundos. Foi a melhor decisão que tomei para evitar os problemas de prazos perdidos que tínhamos anteriormente.
