Avoin data ja JSON-rajapinta
Viikko Nro julkaisee kaiken viikko-, kuukausi-, vuosi-, vuosineljännes-, pyhäpäivä- ja liputuspäivädatansa ilmaisina, staattisina JSON-tiedostoina ilman kirjautumista tai pyyntörajoja. Data kattaa vuodet 2020–2035 ja päivittyy automaattisesti kerran vuorokaudessa.
Sisältö päivitetty 21. elokuuta 2026.
Datasetit
Jokaisesta joukosta on yksi tiedosto per vuosi (tai per vuosi ja viikko/kuukausi/neljännes), sekä hakemistotiedosto (index.json) joka listaa kaikki kyseisen joukon tiedostot.
| Dataset | Kuvaus | URL-kaava | Esimerkki |
|---|---|---|---|
| Viikko | Yksi tiedosto jokaiselle ISO 8601 -viikolle: alkamis- ja päättymispäivä, työpäivien määrä, juhla- ja liputuspäivät, vuosineljännes ja vuodenaika. | /data/week/{vuosi}/{viikko}.json | /data/week/2026/32.json |
| Kuukausi | Yksi tiedosto jokaiselle kalenterikuukaudelle: kuukauden sisältämät ISO-viikot, työpäivien ja viikonloppupäivien määrä, arkipyhät, liputuspäivät sekä vuosineljännes. | /data/month/{vuosi}/{kuukausi}.json | /data/month/2026/8.json |
| Vuosi | Yksi tiedosto jokaiselle vuodelle: viikkojen määrä (52 tai 53), työpäivien ja viikonloppupäivien määrä, arkipyhät, liputuspäivät sekä vuoden ensimmäinen ja viimeinen ISO-viikko. | /data/year/{vuosi}.json | /data/year/2026.json |
| Vuosineljännes | Yksi tiedosto jokaiselle vuosineljännekselle (Q1–Q4): alkamis- ja päättymispäivä, kuukaudet, viikkoväli, työpäivien ja viikonloppupäivien määrä sekä arkipyhät. | /data/quarter/{vuosi}/{neljännes}.json | /data/quarter/2026/3.json |
| Pyhäpäivät | Yksi tiedosto jokaisen vuoden virallisista pyhäpäivistä ja laajasti vietetyistä vapaapäivistä: nimi, päivämäärä, viikonpäivä, ISO-viikko ja virallinen asema. | /data/holidays/{vuosi}.json | /data/holidays/2026.json |
| Pyhäpäivä (yksittäinen) | Yksi tiedosto jokaista nimettyä pyhäpäivää kohti per vuosi: päivämäärä, viikonpäivä, ISO-viikko, vuosineljännes, virallinen asema, määräytymissääntö ja lainsäädäntöperuste (kun se on vahvistettu). | /data/holiday/{vuosi}/{tunniste}.json | /data/holiday/2026/itsenaisyyspaiva.json |
| Liputuspäivät | Yksi tiedosto jokaisen vuoden liputuspäivistä: nimi, päivämäärä, viikonpäivä, ISO-viikko, tyyppi ja mahdollinen päällekkäisyys pyhäpäivän kanssa. | /data/flag-days/{vuosi}.json | /data/flag-days/2026.json |
| Kuukausittainen työpäivädata | Yksi tiedosto jokaiselle kuukaudelle: työpäivien ja viikonloppupäivien määrä sekä sen kuukauden arkipyhät. | /data/monthly-working-days/{vuosi}/{kuukausi}.json | /data/monthly-working-days/2026/8.json |
CSV ja XML
Viikko-, kuukausi-, vuosi-, pyhäpäivä- ja työpäivädata on saatavilla myös CSV- ja XML-muodossa, koko vuoden kerralla yhdessä tiedostossa (ei per tietue kuten JSON). Jokaisella datasetilla on oma sivunsa, jolla on lataus vuosittain sekä kenttäselitykset:
Esimerkki: /data/week/2026/32.json
{
"schemaVersion": "1.0",
"week": 32,
"year": 2026,
"startDate": "2026-08-03",
"endDate": "2026-08-09",
"workingDays": 5,
"holidays": [],
"flagDays": [],
"quarter": 3,
"season": "summer",
"url": "https://viikkonro.fi/viikko-32-2026"
}Esimerkki: /data/year/2026.json
{
"schemaVersion": "1.0",
"year": 2026,
"weekCount": 53,
"workingDays": 254,
"weekendDays": 104,
"holidays": [
{ "name": "Uudenvuodenpäivä", "date": "2026-01-01", "official": true },
{ "name": "Loppiainen", "date": "2026-01-06", "official": true }
// ... loput vuoden 2026 pyhäpäivät
],
"flagDays": [
{ "name": "J. L. Runebergin päivä", "date": "2026-02-05" },
{ "name": "Kalevalan päivä", "date": "2026-02-28" }
// ... loput vuoden 2026 liputuspäivät
],
"firstWeek": { "week": 1, "year": 2026 },
"lastWeek": { "week": 53, "year": 2026 },
"url": "https://viikkonro.fi/vuosi-2026"
}Kehittäjäystävällinen /api/-alias
Samat viikko-, kuukausi-, vuosi- ja pyhäpäivätiedostot ovat saatavilla myös osoitteista /api/week/{viikko}/{vuosi}.json, /api/month/{kuukausi}/{vuosi}.json, /api/year/{vuosi}.json ja /api/holiday/{tunniste}/{vuosi}.json — tutumpi polkumuoto kehittäjille, jotka odottavat REST-tyylistä /api/-etuliitettä. Nämä ovat pysyviä 301-uudelleenohjauksia yllä olevaan /data/-osoitteeseen, eivät erillinen, itsenäisesti ylläpidetty kopio — sisältö on aina täsmälleen sama, eikä samasta datasta synny kahta kilpailevaa kanonista osoitetta.
| /api/-osoite | Ohjautuu osoitteeseen |
|---|---|
/api/week/32/2026.json | /data/week/2026/32.json |
/api/month/8/2026.json | /data/month/2026/8.json |
/api/year/2026.json | /data/year/2026.json |
/api/holiday/itsenaisyyspaiva/2026.json | /data/holiday/2026/itsenaisyyspaiva.json |
Versiointi
Jokaisessa tiedostossa on schemaVersion-kenttä (nyt "1.0"). Numero nousee vain silloin, kun jokin kenttä poistetaan tai nimetään uudelleen — uuden kentän lisääminen olemassa olevaan tiedostoon ei ole rikkova muutos eikä nosta versiota. Sama numero näkyy myös schema.org/Dataset-merkinnän version-kentässä (ks. alla).
schema.org/Dataset-merkintä
Jokainen dataset on kuvattu myös koneluettavana schema.org/Dataset -merkintänä JSON-LD-muodossa, kokonaisuudessaan osoitteessa /data/dataset.json. Merkintä sisältää nimen, kuvauksen, kielen (fi-FI), kattavuuden vuosina, lisenssin ja DataDownload-viittauksen jokaisen datasetin hakemistotiedostoon.
Käyttöoikeudet ja viittaaminen
Data on vapaasti käytettävissä käyttöehtojen mukaisesti. Kun siteeraat tai näytät dataa, mainitse lähteeksi "Viikko Nro" ja linkitä viikkonro.fi.
Kaikki datasetit yhdellä kertaa
- /data/index.json — kaikki datasetit ja niiden URL-kaavat.
- /data/dataset.json — sama tieto schema.org/Dataset-muodossa.
- /llms.txt ja /ai.txt — koneluettava sivustokuvaus tekoälyjärjestelmille.
Usein kysytyt kysymykset
Onko Viikko Nron dataa saa käyttää ilmaiseksi?
Kyllä. Kaikki /data/-tiedostot ovat julkisesti saatavilla ilman kirjautumista, API-avainta tai pyyntörajoja. Käyttö edellyttää vain maininnan lähteestä (Viikko Nro, viikkonro.fi) — tarkat ehdot löytyvät käyttöehdoista.
Miten datan versiointi toimii?
Jokaisessa tiedostossa on schemaVersion-kenttä (nyt "1.0"). Numero nousee vain silloin, kun jokin kenttä poistetaan tai nimetään uudelleen — uuden kentän lisääminen ei ole rikkova muutos eikä nosta versiota.
Kuinka usein data päivittyy?
Kaikki tiedostot generoidaan uudelleen jokaisessa julkaisussa ja lisäksi kerran vuorokaudessa automaattisen yöllisen julkaisun yhteydessä, joten data pysyy ajan tasalla ilman erillistä toimenpidettä.
Kuinka pitkälle tulevaisuuteen ja historiaan dataa on saatavilla?
Jokaiselle joukolle on tiedosto vuosilta 2020–2035 (kuluva vuosi + yhdeksän seuraavaa vuotta, sekä kaksi edeltävää). Vanhentuneet vuodet säilyvät tiedostoina, eivätkä ne katoa ajan myötä.
Mistä löydän kaikki datasetit yhdellä kertaa?
Osoitteesta /data/index.json löytyvät kaikki datasetit ja niiden URL-kaavat. Osoitteesta /data/dataset.json löytyy sama tieto schema.org/Dataset-muodossa.
Voiko dataa hakea selaimen JavaScriptillä toiselta sivustolta?
Kyllä. /data/-tiedostot lähetetään Access-Control-Allow-Origin: * -otsikolla, joten selaimen fetch()-kutsu toimii mistä tahansa alkuperästä ilman CORS-virhettä.