Nager.Date

Consulta le festività per paese e anno con Nager.Date, distingue le date nazionali da quelle regionali e usa la risposta come base per un calendario.

Documentazione ufficiale

Risposta pubblica attuale

Carica la risposta da Nager.Date; non serve inserire un termine.

Cosa contiene la risposta

Consulta le festività per paese e anno con Nager.Date, distingue le date nazionali da quelle regionali e usa la risposta come base per un calendario.

Una festività nazionale presente nell elenco non chiarisce necessariamente gli orari di banche, scuole, negozi, consegne o uffici pubblici in una città precisa. Controlla subdivisionCodes, holidayTypes e il canale ufficiale competente prima di comunicare una scadenza, un congedo, un pagamento o un orario di servizio.

Campi da controllare

Data in formato ISO
Nome della festività
Portata nazionale o regionale
Tipi di festività

Cosa restituisce la consultazione annuale

La rotta Holidays inserisce paese e anno nel percorso. Per BR e 2026, la risposta osservata è una lista di oggetti. Ogni oggetto contiene date nel formato AAAA-MM-GG, name, countryCode, nationalHoliday, subdivisionCodes e holidayTypes. Non ogni festività vale per l intero paese, quindi leggi la portata prima di segnare una data come indisponibile per tutti.

Usa countryCode come codice del paese interrogato, non come indicatore di città.
Leggi nationalHoliday insieme a subdivisionCodes; una data può essere limitata a una suddivisione.
Considera holidayTypes una classificazione del servizio, non una conferma degli orari locali.

Come preparare una richiesta utile

Scegli prima il paese tramite il suo codice ISO di due lettere e poi l anno da pianificare. Questa pagina mostra BR e 2026 perché una risposta annuale rende i campi confrontabili in una sola lista. Per un calendario di gruppo, conserva separatamente data e portata invece di trasformare ogni voce in un giorno libero nazionale.

Mantieni l anno esplicito nell URL per non mescolare calendari di periodi diversi.
Controlla il codice paese prima di riutilizzare una risposta in un altro progetto.
Ordina le date e metti in evidenza solo quelle che corrispondono al luogo o alla regola da considerare.

Cautela prima di usare le scadenze

Un elenco di festività aiuta a pianificare, ma da solo non decide se ci saranno servizio, regolamento bancario, consegna, lezione o obbligo legale. La portata può cambiare in base a città, istituzione e attività. Se una data riguarda denaro, contratto, termine pubblico o viaggio, conferma la regola con l ente, l azienda o il servizio responsabile.

Non presentare una data regionale come chiusura nazionale senza controllare i campi restituiti.
Non calcolare una scadenza legale solo dalla API.
Registra la fonte ufficiale consultata quando una decisione dipende da un orario o obbligo specifico.