Hoje E Feriado Nos Estados Unidos

Como verificar se hoje é feriado nos Estados Unidos

Achei que fosse simples no começo. Qualquer um consegue montar um script que checa feriados americanos em cinco minutos. O problema é que, na prática, os feriados federais dos EUA não são tão lineares quanto parecem no papel, e tentar automatizar isso sem entender os detalhes vai te dar resultado errado com frequência. O caminho mais direto é usar uma API de calendário ou feriados. Existem várias opções gratuitas e pagas. A maioria segue o padrão da NIST (National Institute of Standards and Technology) para feriados federais, mas isso por si só já não resolve tudo.

hoje e feriado nos estados unidos: o problema real

Vou ser direto: a maioria das APIs que você encontrar vão te devolver a lista de feriados baseados no calendário federal americano. Bom para coisas simples. Ruim quando você precisa saber se uma operação específica vai estar aberta ou fechada hoje. O setor privado nos EUA fecha em dias que não são feriado federal, e alguns estados têm feriados próprios que a maioria das APIs ignora. Eu passei um dia inteiro caçando um bug num sistema de agendamento de clientes onde o horário de funcionamento ia pras aranhas. O problema? O sistema considerava que o Memorial Day caía no último segunda-feira de maio, mas um cliente do Alabama entendia feriado de forma diferente porque tinha seu próprio calendário. A data oficial do governo era uma coisa, a realidade operacional era outra completamente. Levei cerca de 4 horas para resolver simplesmente porque não tinha considerado que clientes privados operam em janelas diferentes.

A solução que eu uso agora é mais simples do que parece. Em vez de depender só de uma API genérica, eu mantenho uma camada de configuração própria sobre a resposta da API. Isso custa mais tempo inicial, mas evita que o sistema quebre todo mês quando algum feriado for observado de forma diferente pelo seu negócio.

Implementação prática

Vamos começar com uma abordagem baseada em Python, que é o que eu mais uso. A biblioteca workingdays lida bem com feriados americanos se configurada corretamente. Você instala com:

pip install workingdays Depois, o código básico fica assim:

import workingdays
us = workingdays.US()
today = workingdays.today()
print(f"É feriado hoje? {us.is_working_day(today)}") Isso responde se hoje é dia útil segundo o calendário federal. Mas aqui está o detalhe que quase ninguém menciona: feriados federais dos EUA que caem num domingo são observados na segunda-feira seguinte. Se cair numa sexta, muitos negócios simplesmente fecham na sexta também sem motivo oficial. A API sozinha não captura essa nuance.

Se você precisa de algo mais robusto para produção, a melhor opção que eu encontrei foi a API do FedHoliday ou a Nager.Date. Ambas têm endpoints gratuitos que retornam os feriados do ano corrente em JSON. Funcionam assim: import requests
response = requests.get("https://date.nager.at/api/v3/PublicHolidays/2025/US")
holidays = response.json()
hoje = datetime.date.today()
feriado_hoje = any(h["date"] == hoje.isoformat() for h in holidays)

A resposta te dá data, nome do feriado, tipo e se é observância nacional. O campo "localName" te diz o nome oficial em inglês. Útil para quem quer montar um display simples.

Edge cases que você precisa conhecer

Cinco problemas específicos que eu já vi quebrarem sistemas em produção: 1. Emenda do Feriado (Holidays Act): Quando um feriado cai num sábado, o feriado civil é na sexta. Quando cai num domingo, é na segunda. A maioria das APIs lida com isso, mas verifique sempre. Eu já vi um sistema de e-commerce calcular promoções de Black Friday erradas porque o feriado de Ação de Graças estava sendo considerado no cálculo de dias úteis e isso afetou a janela de vendas.

2. Feriados estaduais específicos: Alguns estados americanos celebram feriados que não existem no calendário federal. Louisiana tem o dia de Jefferson Davis. Mississippi comemora o Dia de Jefferson Davis também. Missouri tem o Dia de Nat Turner. Se seu negócio opera nacionalmente, essas datas podem ser críticos para o pessoal do RH, mesmo que a API principal não as inclua. 3. Feriados bancários vs. federais: O Federal Reserve tem seu próprio calendário de fechamento. Ele não é idêntico ao calendário federal para o público. Bancos fecham em dias que o governo não fecha, e vice-versa. Se você está construindo algo financeiro, use o calendário do Federal Reserve, não o geral.

4. Fuso horário: Feriados nos EUA são calculados no fuso horário local. Se seu servidor está na Europa e você recebe dados de uma API que não considera timezone, "hoje" pode ser outro dia para o usuário americano. Isso é trivial de resolver, mas é a causa número um de bugs relatados. 5. Feriados móveis: Dia de Ação de Graças é sempre quarta quinta-feira de novembro. Dia de Trabalho (Labor Day) é sempre primeira segunda-feira de setembro. Pentecostes varia todo ano. Feriados baseados em lua cheia são especialmente chatos de calcular — o Dia da Independência é fixo, mas feriados como o Carnaval (que afeta negócios no sul dos EUA) dependem do calendário lunar.

Alternativas que funcionam melhor

Se você está fazendo algo sério, parar de usar APIs genéricas e construir sua própria tabela de feriados baseada na legislação local é mais rápido do que tentar adivinhar. Eu passei de 6 meses otimizando consultas a APIs para simplesmente manter uma tabela SQL com feriados dos últimos 10 anos e projeção para os próximos 10. Custou duas tardes de trabalho. Desde então, nunca mais tive que lidar com problemas de latência ou inconsistência. Para quem não quer escrever código do zero, o serviço do calendarr.com oferece uma API simples, mas paga para acesso ilimitado. A versão gratuita tem rate limiting que é irritante em produção. Não recomendo para sistemas que precisam de alta disponibilidade.

Agora, se você só quer uma resposta rápida e casual sobre se hoje é feriado nos Estados Unidos, um site como o timeanddate.com funciona perfeitamente. Basta verificar a página de feriados americanos do site. É lento para automação, mas serve bem para consulta manual. Resumo do que aprendi na prática: não confie cegamente em APIs de feriados. Sempre valide contra uma fonte oficial como o site do governo dos EUA (USAGov ou OPM), especialmente para negócios que dependem dessas datas para operações críticas. E quando for construir algo do zero, lembre-se de incluir feriados estaduais além dos federais, senão seu sistema vai falhar silenciosamente nos momentos errados.