Funktionsblock TIMESWITCH_GET
Funktionsblocket TIMESWITCH_GET returnerar all information om ett händelse i en tidsur.
Anmärkning: Tidsuren måste vara lagrade i samma element.
Ingång TIMESWITCH
Här lagras tidsurens databas som en sträng. Denna måste redan existera som funktionsblocket TIMESWITCH. Observera även programordningen så att detta funktionsblock initieras korrekt.
Ingång ID
Definierar ID:n för händelsen som en sträng.
Utgång ERR
Vid felaktig situation sätts utgången till sant. Detta kan ske om kalendern inte existerar eller om ID:n inte är definierad eller ogiltig.
Utgång TITLE
Returnerar titeln för händelsen.
Utgång DT_START
Starttiden för händelsen i formatet DT# returneras.
Utgång DT_END
Sluttiden för händelsen i formatet DT# returneras.
Utgång DIS
Om utgången är sant, så är händelsen inaktiverad och ignoreras av tidsprogrammet.
Utgång REPEAT
Utgången returnerar upprepningarna som en sträng. Dessa motsvarar hjälpfunktionerna REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY och REPEAT_HOURLY.
Strängen kan vara separerad med dubbelpunkter eller konstrueras som följer:
w:2:4:135
Den första siffran (liten bokstav) definierar tidsintervallet för upprepningen:
| Förkortning | Tidsintervall |
|---|---|
| h | Varje timme |
| d | Varje dag |
| w | Varje vecka |
| m | Varje månad |
| y | Varje år |
Den andra siffran definierar intervallet som ett heltal för upprepningen. Minsta värdet är 1.
Den tredje siffran definierar slutet på upprepningen. Här kan tre olika format definieras:
- Ingen värde: Upprepningen är oändlig.
- Som ett enkelt heltal: Upprepningen avslutas efter det definierade antalet upprepningar.
- Som datum YYYY-MM-DD: Upprepningen avslutas innan datumet.
Den fjärde siffran definierar veckodagarna då upprepningen sker. Denna siffra används endast vid definition av veckovis eller månadsvis upprepning.
Veckovisa Upprepningar
Det kontrolleras om den aktuella veckodagen finns i talet. Flera dagar kan anges efter varandra. Till exempel 135 för måndag, onsdag och fredag. Om inget värde anges (0 eller en tom sträng), så upprepas det inte på någon dag.
| Talet | Veckodag |
|---|---|
| 1 | Måndag |
| 2 | Tisdag |
| 3 | Onsdag |
| 4 | Torsdag |
| 5 | Fredag |
| 6 | Lördag |
| 7 | Söndag |
Månadsvisa Upprepningar
Definierar vilken veckodag händelsen ska upprepas. Stöds är tal från -1 till 4. 0 eller ingen deklaration upprepas varje månad på samma dag, oberoende av veckodag. Veckodagen hämtas från det första datumet.
| Värde | Beskrivning |
|---|---|
| -1 | Upprepas på sista veckodagen. |
| 0 | Upprepas på samma dag. (Standard) |
| 1 | Upprepas på första veckodagen. |
| 2 | Upprepas på andra veckodagen. |
| 3 | Upprepas på tredje veckodagen. |
| 4 |
Upprepas på fjärde veckodagen. |
Utgång DT_MODIFY
Utgången definierar den senaste ändringen i formatet DT#. Denna ingång kan också vara odefinierad om händelsen skapades innan version 5.0.