Nager.Date

Consulta festivos por país y año con Nager.Date, identifica si cada fecha es nacional o regional y usa la respuesta como punto de partida para organizar calendarios.

Documentación oficial

Respuesta pública actual

Carga la respuesta de Nager.Date; no hace falta escribir un término.

Qué contiene la respuesta

Consulta festivos por país y año con Nager.Date, identifica si cada fecha es nacional o regional y usa la respuesta como punto de partida para organizar calendarios.

Una festividad nacional listada puede no resolver horarios de bancos, escuelas, comercios, entregas u oficinas públicas en una ciudad concreta. Revisa subdivisionCodes, holidayTypes y el canal oficial responsable antes de comunicar un plazo, permiso, pago u horario de atención.

Campos que conviene revisar

Fecha en formato ISO
Nombre de la festividad
Alcance nacional o regional
Tipos de festividad

Qué devuelve la consulta anual

La ruta Holidays coloca país y año en el camino. Para BR y 2026, la respuesta observada es una lista de objetos. Cada objeto incluye date en formato AAAA-MM-DD, name, countryCode, nationalHoliday, subdivisionCodes y holidayTypes. No todas las festividades abarcan todo el país, por lo que conviene leer el alcance antes de marcar una fecha como no disponible para todos.

Usa countryCode como código del país consultado, no como indicador de ciudad.
Lee nationalHoliday junto con subdivisionCodes; una fecha puede limitarse a una subdivisión.
Trata holidayTypes como clasificación del servicio, no como confirmación de horarios locales.

Cómo preparar una consulta útil

Elige primero el país mediante su código ISO de dos letras y después el año que vas a planificar. Esta página muestra BR y 2026 porque la respuesta anual permite comparar los campos en una sola lista. Para un calendario de equipo, guarda fecha y alcance por separado en vez de convertir cada elemento en día libre nacional.

Mantén el año explícito en la URL para no mezclar calendarios de periodos distintos.
Comprueba que el código de país sea el esperado antes de reutilizar la respuesta en otro proyecto.
Ordena las fechas y destaca solo las que correspondan al lugar o la regla que necesitas considerar.

Cuidados antes de usar plazos

Una lista de festivos sirve para planificar, pero por sí sola no decide si habrá atención, compensación bancaria, entrega, clase u obligación legal. La cobertura puede variar según ciudad, institución y actividad. Si la fecha afecta dinero, contrato, plazo público o viaje, confirma la regla con el organismo, empresa o servicio responsable.

No presentes una fecha regional como cierre nacional sin revisar los campos devueltos.
No calcules un plazo legal solo a partir de la API.
Registra la fuente oficial consultada cuando una decisión dependa de un horario u obligación concreta.