Blok funkce TIMESWITCH_GET

Blok funkce TIMESWITCH_GET poskytuje všechny informace o události časového spínače.

Poznámka: Časový spínač musí být uložen v stejném prvku.

Vstup TIMESWITCH

Zde je databáze časového spínače uložena jako řetězec. Musí existovat jako blok funkce TIMESWITCH. Zohledněte také pořadí programu, aby tento blok funkce byl správně inicializován.

Vstup ID

Definuje ID jako řetězec události.

Výstup ERR

V případě chyby je výstup nastaven na pravdu. To může být, pokud kalendář neexistuje nebo byla ID nesprávně nebo neplatně definována.

Výstup TITLE

Poskytuje název události.

Výstup DT_START

Počáteční čas události ve formátu DT#.

Výstup DT_END

Konečný čas události ve formátu DT#.

Výstup DIS

Pokud je výstup pravdivý, je událost deaktivována a je ignorována časovým programem.

Výstup REPEAT

Výstup poskytuje opakování jako řetězec. Odpovídají pomocným funkcím REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY a REPEAT_HOURLY.

Řetězec může být oddělen dvojtečkou nebo mít následující strukturu:

w:2:4:135

První číslice (malé písmeno) definuje časový interval opakování:

Zkratka	Časový interval
h	Hodně
d	Denně
w	Týdně
m	Měsíčně
y	Ročně

Druhá číslice definuje interval jako celé číslo opakování. Nejmenší hodnota je 1.

Třetí číslice definuje konec opakování. Zde lze definovat tři různé formáty:

• Žádná hodnota: Opakování je nekonečné.
• Jako jednoduché celé číslo: Opakování končí po definovaném počtu opakování.
• Jako datum YYYY-MM-DD: Opakování se zastaví před datem.

Čtvrtá číslice definuje dny v týdnu, kdy k opakování dochází. Tato číslice se používá pouze při definici týdenních nebo měsíčních opakování.

Týdenní opakování

Zkontroluje, zda aktuální den v týdnu je přítomen v čísle. Více dnů lze jednoduše zadat za sebou. Například 135 pro pondělí, středu a pátek. Pokud není zadána žádná hodnota (0 nebo prázdný řetězec), opakování se neuskuteční v žádný den.

Číslo	Den v týdnu
1	Pondělí
2	Úterý
3	Středa
4	Čtvrtek
5	Pátek
6	Sobota
7	Neděle

Měsíční opakování

Definuje, v který den v týdnu se událost má opakovat. Podporované jsou hodnoty od -1 do 4. 0 nebo žádné deklarace opakují každý měsíc ve stejný den, nezávisle na dni v týdnu. Den v týdnu je převzat z prvního data.

Hodnota	Popis
-1	Opakuje se v poslední den v týdnu.
0	Opakuje se ve stejný den. (Výchozí)
1	Opakuje se v první den v týdnu.
2	Opakuje se ve druhý den v týdnu.
3	Opakuje se ve třetí den v týdnu.
4	Opakuje se ve čtvrtý den v týdnu.

Výstup DT_MODIFY

Výstup definuje poslední změnu ve formátu DT#. Tento vstup může být také nedefinován, pokud byla událost vytvořena před verzí 5.0.