Nager.Date

Consulte feriados de um país e ano pelo Nager.Date, leia a abrangência nacional ou regional de cada data e use o resultado como base para organizar calendários.

Documentação

Resposta pública atual

Carregue a resposta de Nager.Date; não é necessário digitar um termo.

O que a consulta retorna

Consulte feriados de um país e ano pelo Nager.Date, leia a abrangência nacional ou regional de cada data e use o resultado como base para organizar calendários.

Um feriado listado como nacional pode não resolver horários de bancos, escolas, comércio, entregas ou órgãos em uma cidade específica. Confira subdivisionCodes, holidayTypes e o canal oficial responsável antes de comunicar prazo, folga, pagamento ou atendimento.

Campos que merecem atenção

Data no formato ISO
Nome do feriado
Abrangência nacional ou regional
Tipos de feriado

O que a consulta anual retorna

A rota Holidays usa país e ano no caminho. Para BR e 2026, a resposta observada é uma lista de objetos. Cada objeto traz date no padrão AAAA-MM-DD, name, countryCode, nationalHoliday, subdivisionCodes e holidayTypes. Nem todos os feriados alcançam o país inteiro, por isso o campo de abrangência deve ser lido antes de marcar uma data como indisponível para todos.

Use countryCode como código do país consultado, não como indicação de cidade.
Leia nationalHoliday junto com subdivisionCodes; uma data pode estar limitada a uma subdivisão.
Trate holidayTypes como classificação do serviço, não como confirmação de expediente local.

Como montar uma consulta útil

Escolha primeiro o país pelo código ISO de duas letras e depois o ano que será planejado. A página demonstra BR e 2026 porque o retorno anual deixa os campos comparáveis em uma única lista. Para um calendário de equipe, guarde a data e a abrangência separadamente, em vez de transformar todo item em feriado geral.

Mantenha o ano explícito na URL para evitar misturar calendários de períodos diferentes.
Confira se o código de país é o esperado antes de reutilizar a resposta em outro projeto.
Ordene as datas e destaque apenas as que correspondem ao local ou à regra que você precisa considerar.

Cuidados antes de usar em prazos

Uma lista de feriados é útil para planejamento, mas não decide sozinha se haverá atendimento, compensação bancária, entrega, aula ou obrigação legal. A cobertura pode mudar conforme a cidade, a instituição e o tipo de atividade. Quando a data afetar dinheiro, contrato, prazo público ou viagem, confirme a regra no órgão, empresa ou serviço responsável.

Não apresente uma data regional como paralisação nacional sem conferir os campos retornados.
Evite calcular prazo legal apenas a partir da API.
Registre a fonte oficial consultada quando a decisão depender de horário ou obrigação específica.