Blok Funkce TIMESWITCH_ADD

Blok funkce TIMESWITCH_ADD vytváří nebo upravuje událost v časovém spínači.

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

Tip: K úpravě události lze všechny hodnoty pomocí bloku funkce TIMESWITCH_GET vyčíst.

Vstup ADD

Vstup vytváří nebo upravuje událost v kalendáři při pozitivní hraně. Je-li vstup vždy pravdivý, tak se událost, jakmile je smazána, znovu vytvoří. Změny události nejsou rozpoznány.

Důležité: Vytváření a současné mazání by mělo být vyhnuto, protože to může velmi zatížit SSD.

Vstup TIMESWITCH

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

Vstup ID

Definuje ID jako řetězec události. To umožňuje jednoznačnou identifikaci a zabraňuje tomu, aby jiné události vytvořily konflikt. ID by měla obsahovat pouze písmena a číslice. Velikost písmen se bere v úvahu.

Poznámka: ID by měla být pro všechny kalendáře jednoznačně definována. Událost může uživatel na vizualizaci zkopírovat do jiného kalendáře.

Vstup TITLE

Název události jako řetězec. Tento by neměl obsahovat žádné přechody řádků. Pokud je vstup ADD pravdivý, tak se každá změna okamžitě zapíše do kalendáře.

Vstup DT_START

Počáteční čas události ve formátu DT# zpět. Pokud je vstup ADD pravdivý, tak se každá změna okamžitě zapíše do kalendáře.

Tip: Časové intervaly lze vypočítat pomocí bloků funkce MKTIME, STR2DT a EASTER_DATE.

Vstup DT_END

Konečný čas události ve formátu DT# zpět. Pokud je vstup ADD pravdivý, tak se každá změna okamžitě zapíše do kalendáře. Je-li konečný čas menší než DT_START, tak se DT_END definuje jako počáteční čas.

Pokud není vstup definován, tak se předpokládá stejná hodnota jako DT_START a událost vytvoří impuls.

Vstup DIS

Vstup deaktivuje událost v kalendáři. Pokud je vstup ADD pravdivý, tak se každá změna okamžitě zapíše do kalendáře.

Vstup REPEAT

Na vstupu lze definovat opakování jako řetězec. Tyto lze generovat pomocí pomocných funkcí REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY a REPEAT_HOURLY nebo jak je popsáno deklarovat.

Řetězec může být oddělen dvojtečkou následovně:

w:2:4:135

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

Zkratka	Časový Interval
h	Hodinově
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 ukončí 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 se, zda je aktuální den v týdnu 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), tak se neopakuje v žádném dni.

Čí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. Podporovány jsou čísla od -1 do 4. 0 nebo žádná deklarace opakuje každý měsíc ve stejný den, nezávisle na dni v týdnu. Den v týdnu se bere z prvního data.

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

Výstup ERR

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