Funkcióblokk TIMESWITCH_ADD

A Funkcióblokk TIMESWITCH_ADD létrehoz vagy módosít egy eseményt az időzítőben.

Megjegyzés: Az időzítőt ugyanabban az elemben kell elhelyezni.

Tip: Az esemény módosításához minden értéket a TIMESWITCH_GET funkcióblokkal lehet kiolvasni.

ADD bemenet

A bemenet létrehoz vagy módosít egy eseményt a naptárban, pozitív él esetén. Ha a bemenet mindig igaz, akkor az esemény, ha törölve lett, újra létrejön. Az esemény módosításait nem ismeri fel.

Fontos: A létrehozás és egyidejű törlés kerülendő, mivel ez nagyon terhelheti az SSD-t.

TIMESWITCH bemenet

Itt a naptár adatbázisa karakterláncként van elhelyezve. Ez már léteznie kell TIMESWITCH funkcióblokk formájában. Vegyék figyelembe a program sorrendjét is, hogy ez a funkcióblokk helyesen inicializálódjék.

ID bemenet

Azt határozza meg az esemény azonosítóját karakterláncként. Ez lehetővé teszi egyedi azonosítást és megakadályozza, hogy más események konfliktust okozzanak. Az ID csak betűkből és számokból állhat. A nagy- és kisbetűket figyelembe veszik.

Megjegyzés: Az ID-t minden naptárra egyedi módon kell definiálni. Egy eseményt a felhasználó a vizualizációban más naptárba is másolhat.

TITLE bemenet

Az esemény címe karakterláncként. Ez nem tartalmazhat sortöréseket. Ha az ADD bemenet igaz, akkor minden módosítás azonnal a naptárba íródik.

DT_START bemenet

Az esemény kezdőideje DT# formátumban. Ha az ADD bemenet igaz, akkor minden módosítás azonnal a naptárba íródik.

Tip: Az időpontokat a MKTIME, STR2DT és EASTER_DATE funkcióblokkokkal lehet kiszámolni.

DT_END bemenet

Az esemény végideje DT# formátumban. Ha az ADD bemenet igaz, akkor minden módosítás azonnal a naptárba íródik. Ha a végidőpont kisebb, mint a DT_START, akkor a DT_END-t kezdőidőpontként definiálják.

Ha a bemenet nem van meghatározva, akkor ugyanazt az értéket veszik fel, mint a DT_START, és az esemény esetén egy impulzus keletkezik.

DIS bemenet

A bemenet letiltja az eseményt a naptárban. Ha az ADD bemenet igaz, akkor minden módosítás azonnal a naptárba íródik.

REPEAT bemenet

A bemenetre a ismétlések karakterláncként vannak meghatározva. Ezeket a REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY és REPEAT_HOURLY segédfüggvényekkel lehet generálni vagy leírni, mint leírtuk.

A karakterlánc kétpontos elválasztással így épül fel:

w:2:4:135

Az első szám (kiscsont) meghatározza az ismétlés időtartamát:

Rövidítés	Időtartam
h	Órásonként
d	Naponta
w	Heti
m	Havi
y	Évenként

A második szám meghatározza az ismétlés intervallumát egész szám formájában. A legkisebb érték 1.

A harmadik szám meghatározza az ismétlés végét. Itt három különböző formátumot lehet definiálni:

• Nincs érték: Az ismétlés végtelen.
• Egyszerű egész számként: Az ismétlés a meghatározott ismétlések száma után ér véget.
• Dátumként YYYY-MM-DD: Az ismétlés a dátum előtt fejeződik be.

A negyedik szám meghatározza a hétnapokat, amelyekre az ismétlés történik. Ezt a számot csak heti vagy havi ismétlések definiálásakor használják.

Heti ismétlések

Ellenőrizni kell, hogy a jelenlegi hétnap szerepel-e a számban. Több nap egyszerűen egymás után megadható. Például 135 hétfőre, szerdára és péntekre. Ha nincs érték megadva (0 vagy üres karakterlánc), akkor semmilyen napon nem történik ismétlés.

Szám	Hétnap
1	Hétfő
2	Kedd
3	Szerda
4	Csütörtök
5	Péntek
6	Szombat
7	Vasárnap

Havi ismétlések

Azt határozza meg, hogy melyik hétnapon kell az eseményt ismételten végrehajtani. Támogatott értékek -1 és 4. 0 vagy nincs deklaráció, akkor minden hónap ugyanazon a napon történik ismétlés, függetlenül a hétnapoktól. A hétnap az első dátum alapján kerül átvételre.

Érték	Leírás
-1	Ismétlés az utolsó hétnapon.
0	Ismétlés ugyanazon a napon. (Alapértelmezett)
1	Ismétlés az első hétnapon.
2	Ismétlés a második hétnapon.
3	Ismétlés a harmadik hétnapon.
4	Ismétlés a negyedik hétnapon.

ERR kimenet

A hiba esetén a kimenetet igazra állítják. Ez akkor történhet, ha a naptár nem létezik vagy az ID-t nem vagy érvénytelenül definiálták.