Tento dokument je sdílenou specifikací pro časové specifikace pro použití v otevřeých formálních normách ve smyslu § 3a odst. 3 zákona č. 106/1999 Sb., o svobodném přístupu k informacím. Specifikace je ilustrována příklady dat ve formátu JSON-LD [[json-ld11]] a tedy i JSON [[ECMA-404]].
V této sekci jsou definovány jednotlivé třídy a jejich vlastnosti potřebné pro popis časové specifikace. Pro každou vlastnost je uveden její identifikátor, který je pro její reprezentaci použit ve všech datových formátech, její název, datový typ, popis a příklad. Všechny třídy, které nejsou specifikovány jinou otevřenou formální normou nebo číselníkem, dědí vlastnosti a vazby třídy Věc.
Tato třída reprezentuje časovou specifikaci. Časová specifikace určuje množinu časových úseků pomocí různých způsobů (časový interval, specifický časový interval, frekvence a další). Výsledná množina časových úseků je průnikem těchto množin. Kromě níže specifikovaných vlastností a vazeb je možné u této třídy použít také vlastnosti a vazby třídy Věc.
počet_opakování
časový_okamžik
časový_interval
den_v_týdnu
https://data.mvcr.gov.cz/zdroj/číselníky/dny-v-týdnu/položky/pondělí
časové_období
http://publications.europa.eu/resource/authority/timeperiod/OCT
frekvence
http://publications.europa.eu/resource/authority/frequency/BIWEEKLY
časová_doba
specifická_frekvence
výjimka
časová_platnost
jiná_časová_specifikace
https://data.mvcr.gov.cz/zdroj/číselníky/jiná-časová-specifikace/položky/dobré-počasí
Určuje opakující se čas nebo dobu ohraničenou různými údaji o čase. Příkladem může být otevírací doba v určitý den, nebo čas vývozu kontejneru.
čas
08:00:00
od
08:00:00
do
23:00:00
Tato třída reprezentuje specifickou frekvenci.
minuta
20
hodina
20
den_v_měsíci
20
týden_v_měsíci
2
týden_v_roce
20
rok_v_desetiletí
2
rok_ve_století
20
V této sekci jsou uvedeny příklady reprezentace časové specifikace, ve formátu JSON-LD [[!json-ld11]], a tedy i JSON [[!ECMA-404]].
Příklad ukazuje minimální časovou specifikaci.
Příklad ukazuje specifikaci konkrétního časového okamžiku.
Příklad ukazuje časovou specifikaci od 00:00:01 dne 1.1.2020 do 23:59:59 dne 31.12.2020 s výjimkou časového intervalu od 9:30:00 dne 21.9.2020 do 10:30:00 dne 21.9.2020.
Příklad ukazuje časovou specifikaci pomocí jiné časové specifikace. Příklad určuje časový interval od 00:00:01 dne 1.1.2020 do 23:59:59 dne 31.12.2020 pouze v případě dobrého počasí.
Příklad ukazuje časovou specifikaci pomocí počtu opakování dané události. Příklad určuje počet opakování 3.
Příklad ukazuje časovou specifikaci v určitém časovém intervalu pomocí opakování dané události. Daná událost se odehraje v časovém intervalu od 00:00:01 dne 1.1.2020 do 23:59:59 dne 31.12.2020 třikrát.
Příklad ukazuje časovou specifikaci s opakováním. Příklad říká "jednou za čtrnáct dní mezi 00:00:01 dne 1.1.2020 a 23:59:59 dne 31.12.2020".
Příklad ukazuje časovou specifikaci s opakováním daným více atributy. Příklad určuje každé druhé říjnové pondělí od 00:00:01 dne 1.1.2020 do 23:59:59 dne 31.12.2021. Tzn. platí 1. pondělí v říjnu roku 2020, poté 3. pondělí v říjnu roku 2020 apod.
Příklad ukazuje časovou specifikaci s výjimkou a opakováním daným více atributy. Příklad určuje každé druhé říjnové pondělí od 00:00:01 dne 1.1.2020 do 23:59:59 dne 31.12.2021 s výjimkou v intervalu od 9:30:00 dne 1.10.2021 do 10:30:00 dne 10.10.2021. Tzn. platí 1. pondělí v říjnu roku 2020, poté 3. pondělí v říjnu roku 2020 apod. a neplatí 1. pondělí v říjnu 2021.
Příklad ukazuje časovou specifikaci s nespecifikovaným koncem, s výjimkou a opakováním daným více atributy. Příklad určuje každé druhé říjnové pondělí od 00:00:01 dne 1.1.2020 s výjimkou intervalu od 9:30:00 dne 1.10.2021 do 10:30:00 dne 10.10.2021. Tzn. platí 1. pondělí v říjnu roku 2020, poté 3. pondělí v říjnu roku 2020 atd. Naopak neplatí 1. pondělí v říjnu 2021.
Příklad ukazuje časovou specifikaci s opakovanou výjimkou a opakováním s více atributy, s nespecifikovaným koncem. Příklad určuje každé první, třetí a případně páté říjnové pondělí od 00:00:01 dne 1.1.2020 do odvolání s výjimkou každého prvního roku v desetiletí od 9:30:00 dne 1.10. daného roku do 10:30:00 dne 10.10. daného roku. Tzn. platí 1. pondělí v říjnu roku 2020, poté 3. pondělí v říjnu roku 2020 a tak obdobně do odvolání. Naopak neplatí prvních deset dní, tj. zejména první pondělí, v říjnu 2021, 2031 apod.
Příklad ukazuje otevírací dobu, tj. od, do, dny v týdnu a časovou platnost otevírací doby. Příklad určuje otevírací dobu každé pondělí, středu a pátek od 09:00:00 do 12:00:00, která platí od 1.1.2020.