Blok funkcija TIMESWITCH_ADD

Blok funkcija TIMESWITCH_ADD stvara ili modifikuje događaj u vremenskoj šalteru.

Napomena: Vremenaš mora biti smješten u isti element.

Savjet: Za modifikaciju događaja sve vrijednosti mogu se pročitati pomoću bloka funkcija TIMESWITCH_GET.

Ulaz ADD

Ulaz stvara ili mijenja događaj u kalendaru, na pozitivnoj ivici. Ako je ulaz uvijek istinit, događaj će se ponovno stvoriti čim bude obrisan. Promjene događaja neće biti prepoznate.

Važno: Stvaranje i istodobno brisanje treba izbjeći, jer to može jako opteretiti SSD.

Ulaz TIMESWITCH

Ovdje se baza podataka šaltera pohranjuje kao niz znakova. Ovaj mora već postojati kao blok funkcija TIMESWITCH. Obratite pažnju i na redoslijed programa, kako bi ovaj blok funkcija bio ispravno inicijaliziran.

Ulaz ID

Definira ID kao niz znakova događaja. Ovo omogućuje jedinstvenu identifikaciju i sprječava da drugi događaji stvore konflikt. ID bi trebao sadržavati samo slova i brojeve. Velika i mala slova se uzimaju u obzir.

Napomena: ID treba biti jedinstveno definiran za sve kalendare. Događaj može korisnik kopirati na vizualizaciji u drugi kalendar.

Ulaz TITLE

Naslov događaja kao niz znakova. Ovaj ne bi trebao sadržavati razmjake u linijama. Ako je ulaz ADD istinit, svaka promjena će biti odmah upisana u kalendar.

Ulaz DT_START

Početni trenutak događaja u formatu DT#. Ako je ulaz ADD istinit, svaka promjena će biti odmah upisana u kalendar.

Savjet: Vremenska razdoblja mogu se izračunati pomoću blokova funkcija MKTIME, STR2DT i EASTER_DATE.

Ulaz DT_END

Završni trenutak događaja u formatu DT#. Ako je ulaz ADD istinit, svaka promjena će biti odmah upisana u kalendar. Ako je završni trenutak manji od DT_START, DT_END će biti definiran kao početni trenutak.

Ako ulaz nije definiran, pretpostavlja se ista vrijednost kao i DT_START i događaj će generirati impuls.

Ulaz DIS

Ulaz deaktivira događaj u kalendaru. Ako je ulaz ADD istinit, svaka promjena će biti odmah upisana u kalendar.

Ulaz REPEAT

Na ulazu se mogu definirati ponavljanja kao niz znakova. Ovi se mogu generirati pomoćnim funkcijama REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY i REPEAT_HOURLY ili deklarirati kao opisano.

Niz znakova može biti konstruiran odvojen dvotočkom na sljedeći način:

w:2:4:135

Prva znamenka (malim slovima) definira vremenski interval ponavljanja:

Skraćenica	Vremenski interval
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 se koristi 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), ponavljanje se ne događa nikad.

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 posljednjem 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 ERR

U slučaju greške izlaz će biti postavljen na istinit. Ovo može biti ako kalendar ne postoji ili ako je ID nije definiran ili nevažeći.