Funkcióblokk TIMESWITCH_GET

A Funkcióblokk TIMESWITCH_GET visszaadja az összes információt egy időzítős óra eseményéről.

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

TIMESWITCH bemenet

Itt a zsebórára vonatkozó adatbázist karakterláncként adjuk meg. Ez már léteznie kell TIMESWITCH funkcióblokk formájában. Figyelembe veendő a program sorrendje is, hogy ez a funkcióblokk helyesen inicializálódjék.

ID bemenet

Definiálja az esemény ID-jét karakterláncként.

ERR kimenet

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

TITLE kimenet

Visszaadja az esemény címét.

DT_START kimenet

A DT# formátumban visszaadott esemény kezdőideje.

DT_END kimenet

A DT# formátumban visszaadott esemény végideje.

DIS kimenet

Ha a kimenet igaz, akkor az esemény deaktiválva van és az időzítőprogram figyelmen kívül hagyja azt.

REPEAT kimenet

A kimenet visszaadja a ismétléseket karakterláncként. Ezek megfelelnek a segédfüggvényeknek: REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY és REPEAT_HOURLY.

A karakterlánc kettősponttal elválasztva vagy az alábbi módon lehet felépítve:

w:2:4:135

Az első számjegy (kiscsont) definiálja a ismétlés időtartamát:

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

A második számjegy definiálja a ismétlés intervallumát egész szám formájában. A legkisebb érték az 1.

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

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

A negyedik számjegy definiálja a hét napjait, amelyek során a ismétlés történik. Ez a számjegy csak heti vagy havi ismétlések meghatározásakor használatos.

Heti ismétlések

Ellenőrizni kell, hogy az aktuális hétnap szerepel-e a számban. Több napot egyszerűen egymás után megadhatunk. Például 135 vasárnapon, szerdán és szombaton. Ha nincs érték megadva (0 vagy üres karakterlánc), akkor napi ismétlés történik.

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

Definiálja, hogy melyik hétnapon kell az eseményt ismételten végrehajtani. A támogatott értékek a -1 és a 4. A 0 vagy nincs deklaráció esetén havonta ugyanazon a napon ismétlődik, függetlenül a hétnapoktól. A hétnap az első dátum alapján lesz átvett.

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

DT_MODIFY kimenet

A kimenet definiálja az utolsó módosítást a DT# formátumban. Ez a bemenet is határozatlan lehet, ha az eseményt a 5.0 verzió előtt hozták létre.