Pyhäpäivädata

Suomen 15 nimetyn pyhäpäivän data jokaiselle vuodelle 2020–2035: päivämäärä, viikonpäivä, ISO-viikko ja virallinen asema. Katso myös pyhäpäiväkohtainen JSON-data (yksi tiedosto per pyhäpäivä), joka sisältää myös lainsäädäntöperusteen ja määräytymissäännön.

Sisältö päivitetty 21 augustus 2026.

Formaatit

FormaattiURL-kaavaEsimerkkiMuoto
JSON (vuosilista)/data/feestdagen/{vuosi}.json/data/feestdagen/2026.jsonYksi tietue, 15 pyhäpäivää
JSON (yksittäinen)/data/feestdag/{jaar}/{naam}.json/data/feestdag/2026/koningsdag.jsonEén record per feestdag
CSV/data/feestdag/{vuosi}.csv/data/feestdag/2026.csv15 riviä
XML/data/feestdag/{vuosi}.xml/data/feestdag/2026.xml15 <holiday>-elementtiä

Kentät

KenttäKuvaus
namePyhäpäivän nimi
datePäivämäärä kyseisenä vuonna
weekdayViikonpäivä
weekISO-viikko, jolle päivä osuu
officialVirallinen (13/15) vai ei-virallinen aattopäivä (2/15)

CSV-sarakkeet: name,date,weekday,week,official

Lataa vuosittain

CSV ja XML sisältävät koko vuoden datan yhdessä tiedostossa:

Usein kysyttyä

Onko pyhäpäivädata ilmaista käyttää?

Kyllä. Kaikki tiedostot ovat julkisesti saatavilla ilman kirjautumista, API-avainta tai pyyntörajoja. Käyttö edellyttää vain maininnan lähteestä (Viikko Nro, viikkonro.fi).

Missä muodoissa data on saatavilla?

JSON, CSV ja XML. JSON on saatavilla yhtenä tietueena kerrallaan; CSV ja XML sisältävät koko vuoden datan yhdessä tiedostossa.

Kuinka usein data päivittyy?

Kaikki tiedostot generoidaan uudelleen jokaisessa julkaisussa ja lisäksi kerran vuorokaudessa automaattisen yöllisen julkaisun yhteydessä.

Aiheeseen liittyviä sivuja

Kalenteritiedot omaan sovellukseen

Valitse ensin tarvittava aineisto: viikko, kuukausi, vuosi, pyhäpäivä tai työpäivät. Lue kenttien merkitykset ja aikavyöhykkeen käyttö. Staattiset aineistot ja avaimella käytettävä Business API ovat erillisiä rajapintoja.

Bron: ISO: päivämäärien ja aikojen esitysmuodot