Funktionsblock TIMESWITCH_GET
Der Funktionsblock TIMESWITCH_GET gibt alle Informationen eines Ereignisses einer Zeitschaltuhr zurück.
Hinweis: Die Zeitschaltuhr muss im gleichen Element hinterlegt sein.
Eingang TIMESWITCH
Hier wird die Datenbank der Schaltuhr als Zeichenkette hinterlegt. Diese muss als Funktionsblock TIMESWITCH bereits existieren. Beachten Sie auch die Reihenfolge des Programms, damit dieser Funktionsblock korrekt initialisiert wird.
Eingang ID
Definiert die ID als Zeichenkette des Ereignisses.
Ausgang ERR
Im Fehlerfall wird der Ausgang auf wahr gesetzt. Dies kann sein, wenn der Kalender nicht existiert oder die ID nicht oder ungültig definiert wurde.
Ausgang TITLE
Gibt den Titel des Ereignisses zurück.
Ausgang DT_START
Der Startzeitpunkt des Ereignisses im Format DT# zurück.
Ausgang DT_END
Der Endzeitpunkt des Ereignisses im Format DT# zurück.
Ausgang DIS
Ist der Ausgang wahr, so ist das Ereignis deaktiviert und wird vom Zeitprogramm ignoriert.
Ausgang REPEAT
Der Ausgang gibt die Wiederholungen als Zeichenkette zurück. Diese entsprechen den Hilfsfunktionen REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY und REPEAT_HOURLY.
Die Zeichenkette kann durch einen Doppelpunkt getrennt oder wie folgt aufgebaut werden:
w:2:4:135
Die erste Ziffer (kleingeschrieben) definiert die Zeitspanne der Wiederholung:
| Kürzel | Zeitspanne |
|---|---|
| h | Stündlich |
| d | Täglich |
| w | Wöchentlich |
| m | Monatlich |
| y | Jährlich |
Die zweite Ziffer definiert das Intervall als Ganzzahl der Wiederholung. Der kleinste Wert ist 1.
Die dritte Ziffer definiert das Ende der Wiederholung. Hier können drei verschiedene Formate definiert werden:
- Kein Wert: Die Wiederholung ist Unendlich.
- Als einfache Ganzzahl: Die Wiederholung endet nach der definierten Anzahl Wiederholungen.
- Als Datum YYYY-MM-DD: Die Wiederholung wird vor dem Datum beendet.
Die vierte Ziffer definiert die Wochentage, an denen die Wiederholung stattfindet. Dieser Ziffer wird nur bei der Definierung von wöchentlichen oder monatlichen Wiederholungen verwendet.
Wöchentliche Wiederholungen
Es wird geprüft, ob der aktuelle Wochentag in der Zahl vorhanden ist. Mehrere Tage können einfach hintereinander angegeben werden. Wie z.B. 135 für Montag, Mittwoch und Freitag. Wird kein Wert angegeben (0 oder eine leere Zeichenkette), so wird an keinem Tag wiederholt.
| Zahl | Wochentag |
|---|---|
| 1 | Montag |
| 2 | Dienstag |
| 3 | Mittwoch |
| 4 | Donnerstag |
| 5 | Freitag |
| 6 | Samstag |
| 7 | Sonntag |
Monatliche Wiederholungen
Definiert an welchem Wochentag das Ereignis wiederholt werden soll. Unterstützt werden Zahlen von -1 bis 4. 0 oder keine Deklaration wiederholt jedem monatlich am selben Tag, unabhängig vom Wochentag. Der Wochentag wird vom ersten Datum übernommen.
| Wert | Beschreibung |
|---|---|
| -1 | Wiederholt am letzten Wochentag. |
| 0 | Wiederholt am selben Tag. (Standard) |
| 1 | Wiederholt am ersten Wochentag. |
| 2 | Wiederholt am zweiten Wochentag. |
| 3 | Wiederholt am dritten Wochentag. |
| 4 |
Wiederholt am vierten Wochentag. |
Ausgang DT_MODIFY
Der Ausgang definiert die letzte Änderung im Format DT#. Dieser Eingang kann auch undefiniert sein, wenn das Ereignis vor der Version 5.0 erstellt wurde.