Funksjonsblokk TIMESWITCH_GET
Funksjonsblokken TIMESWITCH_GET gir alle informasjonene til en hendelse i en tidsstyrt bryter.
Merk: Tidsstyrte brytere må være lagret i samme element.
Inngang TIMESWITCH
Her blir databasen til klokkeslangeren lagret som en streng. Denne må allerede eksistere som funksjonsblokken TIMESWITCH. Vær også oppmerksom på rekkefølgen i programmet, slik at denne funksjonsblokken initialiseres korrekt.
Inngang ID
Definerer ID-en som en streng for hendelsen.
Utgang ERR
I tilfelle av feil blir utgangen satt til sant. Dette kan skje hvis kalenderen ikke eksisterer eller om ID-en ikke er definert eller ugyldig.
Utgang TITLE
Returnerer tittelen på hendelsen.
Utgang DT_START
Starttidspunktet for hendelsen i formatet DT# returneres.
Utgang DT_END
Sluttidspunktet for hendelsen i formatet DT# returneres.
Utgang DIS
Hvis utgangen er sant, er hendelsen deaktivert og blir ignorert av tidsprogrammet.
Utgang REPEAT
Utgangen gir gjentakelsene som en streng. Disse svarer til hjelpefunksjonene REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY og REPEAT_HOURLY.
Strengen kan være adskilt av en dobbelpunkt eller bygget opp som følger:
w:2:4:135
Det første sifferet (litt) definerer tidsintervallet for gjentakelsen:
| Forkortelse | Tidsintervall |
|---|---|
| h | Hvert time |
| d | Daglig |
| w | Ukentlig |
| m | Månedlig |
| y | Årlig |
Det andre sifferet definerer intervallet som et heltall for gjentakelsen. Den minste verdien er 1.
Det tredje sifferet definerer slutten på gjentakelsen. Her kan tre forskjellige formater defineres:
- Ingen verdi: Gjentakelsen er uendelig.
- Som et enkelt heltall: Gjentakelsen slutter etter det definerte antallet gjentakelser.
- Som dato YYYY-MM-DD: Gjentakelsen blir avsluttet før datoen.
Det fjerde sifferet definerer ukedagene som gjentakelsen skjer på. Dette sifferet brukes bare ved definering av ukentlige eller månedlige gjentakelser.
Ukentlige Gjentakelser
Det sjekkes om den aktuelle ukedagen er til stede i tallet. Flere dager kan angis enkelt etter hverandre. For eksempel 135 for mandag, onsdag og fredag. Hvis ingen verdi er angitt (0 eller en tom streng), så gjentas det ikke på noen dag.
| Tall | Ukedag |
|---|---|
| 1 | Mandag |
| 2 | Tirsdag |
| 3 | Onsdag |
| 4 | Torsdag |
| 5 | Fredag |
| 6 | Lørdag |
| 7 | Søndag |
Månedlige Gjentakelser
Definerer hvilken ukedag hendelsen skal gjentas på. Tall fra -1 til 4 støttes. 0 eller ingen deklarasjon gjentar hver måned på samme dag, uavhengig av ukedag. Ukedagen overføres fra det første datoen.
| Verdi | Beskrivelse |
|---|---|
| -1 | Gjentar på siste ukedag. |
| 0 | Gjentar på samme dag. (Standard) |
| 1 | Gjentar på første ukedag. |
| 2 | Gjentar på andre ukedag. |
| 3 | Gjentar på tredje ukedag. |
| 4 |
Gjentar på fjerde ukedag. |
Utgang DT_MODIFY
Utgangen definerer siste endring i formatet DT#. Denne inngangen kan også være udefinert hvis hendelsen ble opprettet før versjon 5.0.