Qué contiene la respuesta
Prueba BR, US y JP y usa los campos devueltos para identificar el registro correcto.
Campos que conviene revisar
- Fecha
- Nombre local
- Ámbito
- Tipo de festivo
Nager.Date Holidays
Fecha · Nombre local · Ámbito · Tipo de festivo
Consulta en vivo
Escribe una búsqueda real, revisa las tarjetas y confirma los datos clave antes de abrir la fuente completa.
Ejemplos rápidos
El país y el año definen el calendario consultado
La consulta de festivos usa un código de país y, en el endpoint anual, también el año. Cada elemento incluye date, localName, name y countryCode. date usa el formato AAAA-MM-DD; localName conserva el nombre usado en ese país, mientras name puede ofrecer otra presentación. Elige país y año antes de comparar fechas, porque una misma celebración puede tener nombres o fechas distintas según el lugar.
- Usa códigos de país de dos letras, como BR, US o JP.
- Conserva countryCode junto a la fecha al crear un calendario internacional.
- Muestra localName cuando el contexto local sea importante para quien lee.
El alcance y el tipo requieren una lectura cuidadosa
global, counties y types ayudan a interpretar el alcance de un elemento. Un festivo puede no aplicarse a todo el país o tener límites territoriales indicados en counties. types clasifica el registro en la fuente, pero no sustituye comprobar una norma, contrato laboral, calendario escolar o aviso de una autoridad local. Úsalo para organizar una consulta, no para afirmar una obligación.
- Revisa counties antes de tratar una fecha como nacional.
- Muestra types como clasificación proporcionada por la fuente.
- Para decisiones oficiales, confirma el calendario del lugar o institución correspondiente.
Las fechas futuras deben consultarse otra vez
La API ofrece listas anuales y una ruta de próximos festivos. fixed y launchYear aparecen como metadatos en algunos resultados, pero el conjunto devuelto sigue ligado al país y período solicitados. Si una agenda depende de una fecha futura, vuelve a consultar cerca del uso y registra cuándo se obtuvieron los datos. Así evitas reutilizar una lista antigua para otro año o lugar.
- Usa la lista anual para planificar un período concreto.
- Usa próximos festivos para una vista breve y actual.
- Registra año, país y momento de consulta al publicar un calendario.
