Dati aperti sui giorni festivi: JSON e ICS

Indirizzi (stabili, versione 1)

Tutti i file sono statici e restano in cache per un giorno. Codice paese = ISO 3166-1 alpha-2 in minuscolo, codici regione = ISO 3166-2 senza prefisso del paese.

https://toolboxday.com/data/v1/holidays/index.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.ics

index.json · /data/v1/holidays/de/2027.json · /data/v1/holidays/fr/2027.ics

{
  "date": "2027-01-06",
  "id": "heiligeDreiKoenige",
  "name": "Epiphany",
  "localName": "Heilige Drei Könige",
  "nationwide": false,
  "regions": [
    "BW",
    "BY",
    "ST"
  ]
}

Esempi di codice

JavaScript

const res = await fetch('https://toolboxday.com/data/v1/holidays/de/2027.json');
const data = await res.json();
// nationwide holidays + holidays of one state (e.g. Bavaria = "BY")
const byState = data.holidays.filter(
  (h) => h.nationwide || h.regions?.includes('BY')
);
console.log(byState.map((h) => `${h.date} ${h.name}`));

Python

import json, urllib.request

url = "https://toolboxday.com/data/v1/holidays/de/2027.json"
data = json.load(urllib.request.urlopen(url))
for h in data["holidays"]:
    where = "nationwide" if h["nationwide"] else ", ".join(h["regions"])
    print(h["date"], h["name"], "-", where)

curl + jq

curl -s https://toolboxday.com/data/v1/holidays/de/2027.json | jq '.holidays[] | select(.nationwide) | .date'

Abbonarsi nel calendario

I file ICS contengono le festività nazionali. Google Calendar: «Altri calendari → Da URL»; Outlook: «Aggiungi calendario → Sottoscrivi dal Web»; iPhone: «Impostazioni → Calendario → Account → Aggiungi calendario sottoscritto».

https://toolboxday.com/data/v1/holidays/fr/2027.ics

Come vengono verificati i dati

• Germania: calcolata dalle 16 leggi regionali sulle festività e dal Trattato di unificazione, con test automatici.
• Altri paesi: generati con python-holidays e confrontati con Nager.Date e i calendari pubblici delle festività di Google. Paesi, anni o regioni con differenze non sono inclusi.
• Le festività del calendario lunare riportano «estimated»: la data può variare di un giorno in base all’avvistamento della luna. Nessuna garanzia – fa fede la fonte ufficiale.

Vacanze scolastiche

I file JSON della Germania contengono anche le vacanze scolastiche dei 16 Länder (fonte: KMK e ministeri regionali), se pubblicate ufficialmente.

Le vacanze scolastiche di altri paesi (OpenHolidays API) sono in un file separato con licenza Open Database License (ODbL 1.0): /data/schulferien-welt.json

Avete trovato un errore o manca un paese? Scriveteci: info@saracai.de