Blok funkcji TIMESWITCH_GET

Blok funkcji TIMESWITCH_GET zwraca wszystkie informacje dotyczące zdarzenia zegara czasu.

Uwaga: Zegar czasowy musi być umieszczony w tym samym elemencie.

Wejście TIMESWITCH

Tutaj baza danych zegara jest przechowywana jako ciąg znaków. Musi istnieć jako blok funkcji TIMESWITCH. Zwróć uwagę na kolejność programu, aby ten blok funkcji został poprawnie zainicjowany.

Wejście ID

Definiuje identyfikator zdarzenia jako ciąg znaków.

Wyjście ERR

W przypadku błędu wyjście jest ustawione na prawdę. Może to być, jeśli kalendarz nie istnieje lub identyfikator nie został zdefiniowany lub jest nieprawidłowy.

Wyjście TITLE

Zwraca tytuł zdarzenia.

Wyjście DT_START

Początek zdarzenia w formacie DT#.

Wyjście DT_END

Koniec zdarzenia w formacie DT#.

Wyjście DIS

Jeśli wyjście jest prawdziwe, zdarzenie jest dezaktywowane i jest ignorowane przez program czasowy.

Wyjście REPEAT

Wyjście zwraca powtórzenia jako ciąg znaków. Odpowiadają one funkcjom pomocniczym REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY i REPEAT_HOURLY.

Ciąg znaków może być oddzielony dwukropkiem lub zbudowany w następujący sposób:

w:2:4:135

Pierwsza cyfra (mała litera) definiuje przedział czasu powtórzenia:

Skrót	Przedział czasu
h	Co godzinę
d	Codziennie
w	Co tydzień
m	Co miesiąc
y	Corocznie

Druga cyfra definiuje interwał jako całkowita liczba powtórzeń. Najmniejsza wartość to 1.

Trzecia cyfra definiuje koniec powtórzenia. Tutaj można zdefiniować trzy różne formaty:

• Brak wartości: Powtórzenie jest nieskończone.
• Jako prosta liczba całkowita: Powtórzenie kończy się po określonej liczbie powtórzeń.
• Jako data YYYY-MM-DD: Powtórzenie zostaje zakończone przed datą.

Czwarta cyfra definiuje dni tygodnia, w których ma miejsce powtórzenie. Ta cyfra jest używana tylko przy definicji powtórzeń cotygodniowych lub comiesięcznych.

Powtórzenia cotygodniowe

Sprawdzane jest, czy bieżący dzień tygodnia znajduje się w liczbie. Można podać kilka dni jeden po drugim. Na przykład 135 dla poniedziałku, środę i piątek. Jeśli nie zostanie podana żadna wartość (0 lub pusty ciąg znaków), powtórzenie nie ma miejsca w żaden dzień.

Liczba	Dzień tygodnia
1	Poniedziałek
2	Wtorek
3	Środa
4	Czwartek
5	Piątek
6	Sobota
7	Niedziela

Powtórzenia comiesięczne

Definiuje, w który dzień tygodnia zdarzenie ma być powtarzane. Obsługiwane są liczby od -1 do 4. 0 lub brak deklaracji powtarza każdego miesiąca w tym samym dniu, niezależnie od dnia tygodnia. Dzień tygodnia jest pobierany z pierwszej daty.

Wartość	Opis
-1	Powtarza się w ostatni dzień tygodnia.
0	Powtarza się w tym samym dniu. (Domyślnie)
1	Powtarza się w pierwszy dzień tygodnia.
2	Powtarza się w drugi dzień tygodnia.
3	Powtarza się w trzeci dzień tygodnia.
4	Powtarza się w czwarty dzień tygodnia.

Wyjście DT_MODIFY

Wyjście definiuje ostatnią zmianę w formacie DT#. To wejście może być również nie zdefiniowane, jeśli zdarzenie zostało utworzone przed wersją 5.0.