Blok funkcija TIMESWITCH_GET
Blok funkcija TIMESWITCH_GET vraća sve informacije o događaju vremenske ure.
Napomena: Vremena mora biti smještena u istom elementu.
Ulaz TIMESWITCH
Ovdje se baza podataka ure kao niz znakova. Ovo mora postojati kao blok funkcija TIMESWITCH. Obavezno obratite pozornost na redoslijed programa, kako bi ovaj blok funkcija bio ispravno inicijaliziran.
Ulaz ID
Definira ID kao niz znakova događaja.
Izlaz ERR
U slučaju pogreške izlaz se postavlja na istinu. To može biti ako kalendar ne postoji ili ako je ID nije definiran ili je nevažeći.
Izlaz TITLE
Vraća naslov događaja.
Izlaz DT_START
Početni trenutak događaja u formatu DT# vraća.
Izlaz DT_END
Završni trenutak događaja u formatu DT# vraća.
Izlaz DIS
Ako je izlaz istina, onda je događaj deaktiviran i vremenski program ga ignorira.
Izlaz REPEAT
Izlaz vraća ponavljanja kao niz znakova. Ovi odgovaraju pomoćnim funkcijama REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY i REPEAT_HOURLY.
Niz znakova može biti odvojen dvotočkom ili kao što slijedi:
w:2:4:135
Prva znamenka (malim slovima) definira vremenski raspon ponavljanja:
| Skraćenica | Vremenski raspon |
|---|---|
| h | Satično |
| d | Dnevno |
| w | Tjedno |
| m | Mjesečno |
| y | Godišnje |
Druga znamenka definira interval kao cijeli broj ponavljanja. Najmanja vrijednost je 1.
Treća znamenka definira kraj ponavljanja. Ovdje se mogu definirati tri različita formata:
- Nema vrijednosti: Ponavljanje je beskonačno.
- Kao jednostavan cijeli broj: Ponavljanje završava nakon definiranog broja ponavljanja.
- Kao datum YYYY-MM-DD: Ponavljanje se završava prije datuma.
Četvrta znamenka definira dane u tjednu kada se ponavljanje događa. Ova znamenka koristi se samo pri definiranju tjednih ili mjesečnih ponavljanja.
Tjedna ponavljanja
Provjerava se da li je trenutni dan u tjednu prisutan u broju. Više dana može biti jednostavno navedeno jedan za drugim. Na primjer, 135 za ponedjeljak, srijedu i petak. Ako nije navedena vrijednost (0 ili prazan niz znakova), tada se ne ponavlja ni na kojem danu.
| Broj | Dan u tjednu |
|---|---|
| 1 | Ponedjeljak |
| 2 | Utorak |
| 3 | Srijeda |
| 4 | Četvrtak |
| 5 | Petak |
| 6 | Subota |
| 7 | Nedjelja |
Mjesečna ponavljanja
Definira na kojem danu u tjednu se događaj treba ponoviti. Podržani su brojevi od -1 do 4. 0 ili nijedna deklaracija ponavlja se svakog mjeseca istog dana, bez obzira na dan u tjednu. Dan u tjednu preuzima se od prvog datuma.
| Vrijednost | Opis |
|---|---|
| -1 | Ponavlja se na zadnjem danu u tjednu. |
| 0 | Ponavlja se istog dana. (Zadano) |
| 1 | Ponavlja se na prvom danu u tjednu. |
| 2 | Ponavlja se na drugom danu u tjednu. |
| 3 | Ponavlja se na trećem danu u tjednu. |
| 4 |
Ponavlja se na četvrtom danu u tjednu. |
Izlaz DT_MODIFY
Izlaz definira zadnju promjenu u formatu DT#. Ovaj ulaz može biti i nedefiniran ako je događaj stvoren prije verzije 5.0.