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 5. 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ä, juhlapyhä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ä sekä arkipyhät. | /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 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 |
| 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 |
Esimerkki: /data/week/2026/32.json
{
"schemaVersion": "1.0",
"week": 32,
"year": 2026,
"startDate": "2026-08-03",
"endDate": "2026-08-09",
"workingDays": 5,
"holidays": [],
"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
],
"firstWeek": { "week": 1, "year": 2026 },
"lastWeek": { "week": 53, "year": 2026 },
"url": "https://viikkonro.fi/vuosi-2026"
}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ä.