Funktionsblok TIMESWITCH_GET
Funktionsblokken TIMESWITCH_GET returnerer alle oplysninger om en begivenhed i en tidsrelæ.
Bemærk: Tidsrelæet skal være gemt i samme element.
Indgang TIMESWITCH
Her gemmes databasen for tidsrelæet som en streng. Denne skal allerede eksistere som funktionsblokken TIMESWITCH. Bemærk også rækkefølgen af programmet, så denne funktionsblok initialiseres korrekt.
Indgang ID
Definerer ID'en som en streng for begivenheden.
Udgang ERR
I tilfælde af fejl sættes udgangen til sand. Dette kan ske, hvis kalenderen ikke eksisterer eller ID'en ikke er defineret eller ugyldig.
Udgang TITLE
Returnerer titlen på begivenheden.
Udgang DT_START
Starttidspunktet for begivenheden i formatet DT# returneres.
Udgang DT_END
Sluttidspunktet for begivenheden i formatet DT# returneres.
Udgang DIS
Hvis udgangen er sand, er begivenheden deaktiveret og ignoreres af tidsprogrammet.
Udgang REPEAT
Udgangen returnerer gentagelserne som en streng. Disse svarer til hjælpefunktionerne REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY og REPEAT_HOURLY.
Strengen kan adskilles af et kolon eller være opbygget som følger:
w:2:4:135
Det første tal (småt) definerer tidsintervallet for gentagelsen:
| Forkortelse | Tidsinterval |
|---|---|
| h | Timelig |
| d | Daglig |
| w | Ugentlig |
| m | Månedligt |
| y | Årligt |
Det andet tal definerer intervallet som et heltal for gentagelsen. Den mindste værdi er 1.
Det tredje tal definerer slutningen af gentagelsen. Her kan tre forskellige formater defineres:
- Ingen værdi: Gentagelsen er uendelig.
- Som et simpelt heltal: Gentagelsen slutter efter det definerede antal gentagelser.
- Som en dato YYYY-MM-DD: Gentagelsen stopper før datoen.
Det fjerde tal definerer ugedagene, hvor gentagelsen finder sted. Dette tal bruges kun ved definition af ugentlige eller månedlige gentagelser.
Ugentlige gentagelser
Der kontrolleres, om den aktuelle ugedag er til stede i tallet. Flere dage kan angives efter hinanden. For eksempel 135 for mandag, onsdag og fredag. Hvis ingen værdi er angivet (0 eller en tom streng), gentages der ikke på nogen dag.
| Tal | Ugedag |
|---|---|
| 1 | Mandag |
| 2 | Tirsdag |
| 3 | Onsdag |
| 4 | Torsdag |
| 5 | Fredag |
| 6 | Lørdag |
| 7 | Søndag |
Månedlige gentagelser
Definerer, på hvilken ugedag begivenheden skal gentages. Der understøttes tal fra -1 til 4. 0 eller ingen deklaration gentager hver måned på samme dag, uafhængigt af ugedagen. Ugedagen overføres fra den første dato.
| Værdi | Beskrivelse |
|---|---|
| -1 | Gentages på den sidste ugedag. |
| 0 | Gentages på samme dag. (Standard) |
| 1 | Gentages på den første ugedag. |
| 2 | Gentages på den anden ugedag. |
| 3 | Gentages på den tredje ugedag. |
| 4 |
Gentages på den fjerde ugedag. |
Udgang DT_MODIFY
Udgangen definerer den sidste ændring i formatet DT#. Denne indgang kan også være udefineret, hvis begivenheden blev oprettet før version 5.0.