Nager.Date Holidays

Digite a sigla de um país e veja os próximos feriados públicos com data, nome local e alcance.

Documentação

Buscar na API

Digite um termo real, veja a resposta da sua busca imediatamente:

Exemplos rápidos

O que a consulta retorna

A Nager.Date é prática para quem quer conferir feriados futuros sem rodar calendário por calendário. Basta informar a sigla do país e ler a lista pronta.

Uso prático

Ela funciona muito bem como consulta rápida de planejamento. Em segundos você descobre o próximo feriado nacional, regional ou específico de uma área.

Como usar sem complicação

Digite a sigla de um país em duas letras para ver a próxima sequência de feriados públicos.

Campos que merecem atenção

Data
Nome local
Abrangência
Tipo de feriado

Para quem isso costuma servir

Boa para quem está planejando viagem, agenda, calendário escolar ou só quer descobrir o próximo feriado de um país.

Onde essa consulta ajuda

Entrega uma lista pronta para consulta rápida.
Ajuda a distinguir feriados nacionais e recortes regionais.
Funciona bem para planejamento e curiosidade internacional.

País e ano definem o calendário consultado

A consulta de feriados usa o código de país e, no endpoint anual, também o ano. Cada item retornado traz date, localName, name e countryCode. date vem no formato AAAA-MM-DD; localName preserva o nome usado no país, enquanto name pode trazer outra forma de apresentação. Escolha o país e o ano antes de comparar datas, pois a mesma celebração pode ter nomes ou datas diferentes conforme o lugar.

Use códigos de país de duas letras, como BR, US ou JP.
Guarde countryCode junto com a data ao montar uma agenda internacional.
Mostre localName quando o contexto local for importante para quem lê.

Abrangência e tipo pedem leitura cuidadosa

global, counties e types ajudam a interpretar o alcance do item. Um feriado pode não valer para todo o país ou pode ter recortes territoriais indicados em counties. types classifica o registro na fonte, mas não substitui a verificação de uma norma, contrato de trabalho, calendário escolar ou aviso da autoridade local. Use essas informações para organizar uma consulta, não para afirmar uma obrigação.

Confira counties antes de tratar uma data como nacional.
Exiba types como classificação fornecida pela fonte.
Para decisões oficiais, confirme o calendário da localidade ou instituição envolvida.

Datas futuras devem ser consultadas novamente

A API oferece listas anuais e uma rota de próximos feriados. fixed e launchYear aparecem como metadados em alguns resultados, mas o conjunto devolvido continua ligado ao país e ao período pedidos. Se uma agenda depender de uma data futura, refaça a consulta perto do uso e registre quando os dados foram obtidos. Isso evita reaproveitar uma lista antiga para outro ano ou local.

Use a lista anual para planejar um período definido.
Use próximos feriados para uma visualização curta e atualizada.
Registre ano, país e momento da consulta ao publicar um calendário.