Cosa contiene la risposta
Prova BR, US e JP e usa i campi restituiti per identificare la scheda corretta.
Campi da controllare
- Nome locale
- Ambito
- Tipo di festività
Nager.Date Holidays
Nome locale · Ambito · Tipo di festività
Consultazione live
Scrivi una ricerca reale, leggi le schede e conferma i dettagli principali prima di aprire la fonte completa.
Esempi rapidi
Paese e anno definiscono il calendario richiesto
La richiesta dei festivi usa un codice paese e, nell’endpoint annuale, anche l’anno. Ogni elemento restituito include date, localName, name e countryCode. date usa il formato AAAA-MM-GG; localName conserva il nome usato nel paese, mentre name può offrire un’altra presentazione. Scegli paese e anno prima di confrontare date, perché la stessa ricorrenza può avere nomi o date diversi a seconda del luogo.
- Usa codici paese di due lettere, come BR, US o JP.
- Conserva countryCode con la data quando crei un calendario internazionale.
- Mostra localName quando il contesto locale è importante per chi legge.
Ambito e tipo richiedono una lettura attenta
global, counties e types aiutano a interpretare l’ambito di un elemento. Un festivo può non valere per l’intero paese o avere limiti territoriali indicati in counties. types classifica il record nella fonte, ma non sostituisce la verifica di una norma, un contratto di lavoro, un calendario scolastico o un avviso dell’autorità locale. Usalo per organizzare una ricerca, non per affermare un obbligo.
- Controlla counties prima di trattare una data come nazionale.
- Mostra types come classificazione fornita dalla fonte.
- Per decisioni ufficiali, conferma il calendario del luogo o dell’istituzione interessati.
Le date future vanno consultate di nuovo
L’API offre liste annuali e una rotta per i prossimi festivi. fixed e launchYear compaiono come metadati in alcuni risultati, ma l’insieme restituito resta legato al paese e al periodo richiesti. Se un’agenda dipende da una data futura, ripeti la richiesta vicino al momento d’uso e registra quando hai ottenuto i dati. Così non riusi un elenco vecchio per un altro anno o luogo.
- Usa la lista annuale per pianificare un periodo definito.
- Usa i prossimi festivi per una vista breve e aggiornata.
- Registra anno, paese e momento della richiesta quando pubblichi un calendario.
