Blok funkcji TIMESWITCH_ADD

Blok funkcji TIMESWITCH_ADD tworzy lub modyfikuje zdarzenie w zegarze czasowym.

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

Porada: Aby zmodyfikować zdarzenie, wszystkie wartości można odczytać za pomocą bloku funkcji TIMESWITCH_GET.

Wejście ADD

Wejście tworzy lub modyfikuje zdarzenie w kalendarzu przy pozytywnej krawędzi. Jeśli wejście jest zawsze prawdziwe, zdarzenie zostanie ponownie utworzone, gdy zostanie usunięte. Zmiany zdarzenia nie są wykrywane.

Ważne: Tworzenie i jednoczesne usuwanie należy unikać, ponieważ może to bardzo obciążyć SSD.

Wejście TIMESWITCH

Tutaj baza danych zegara czasowego jest zapisana jako łańcuch znaków. Musi istnieć jako blok funkcji TIMESWITCH. Zwróć uwagę również na kolejność programu, aby ten blok funkcji został poprawnie zainicjowany.

Wejście ID

Definiuje identyfikator zdarzenia jako łańcuch znaków. Pozwala to na jednoznaczną identyfikację i zapobiega konfliktom z innymi zdarzeniami. Identyfikator powinien składać się tylko z liter i cyfr. Wielkość liter jest uwzględniana.

Uwaga: Identyfikator powinien być jednoznacznie określony dla wszystkich kalendarzy. Zdarzenie może zostać skopiowane przez użytkownika na wizualizacji do innego kalendarza.

Wejście TITLE

Tytuł zdarzenia jako łańcuch znaków. Nie powinien zawierać przerwy linii. Jeśli wejście ADD jest prawdziwe, każda zmiana zostanie natychmiast zapisana w kalendarzu.

Wejście DT_START

Początek zdarzenia w formacie DT#. Jeśli wejście ADD jest prawdziwe, każda zmiana zostanie natychmiast zapisana w kalendarzu.

Porada: Czas przełączania można obliczyć za pomocą bloków funkcji MKTIME, STR2DT i EASTER_DATE.

Wejście DT_END

Koniec zdarzenia w formacie DT#. Jeśli wejście ADD jest prawdziwe, każda zmiana zostanie natychmiast zapisana w kalendarzu. Jeśli koniec zdarzenia jest mniejszy niż DT_START, DT_END zostanie zdefiniowany jako początek zdarzenia.

Jeśli wejście nie jest zdefiniowane, przyjmowana jest taka sama wartość jak DT_START i generowany jest impuls w zdarzeniu.

Wejście DIS

Wejście dezaktywuje zdarzenie w kalendarzu. Jeśli wejście ADD jest prawdziwe, każda zmiana zostanie natychmiast zapisana w kalendarzu.

Wejście REPEAT

Na wejściu można zdefiniować powtórzenia jako łańcuch znaków. Można je wygenerować za pomocą funkcji pomocniczych REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY i REPEAT_HOURLY lub zadeklarować, jak opisano.

Łańcuch znaków może być zbudowany, oddzielony dwukropkiem, w następujący sposób:

w:2:4:135

Pierwsza cyfra (małymi literami) określa przedział czasu powtórzenia:

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

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

Trzecia cyfra określa 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 tą datą.

Czwarta cyfra określa dni tygodnia, w których ma miejsce powtórzenie. Ta cyfra jest używana tylko przy definiowaniu 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 łańcuch znaków), powtórzenie nie występuje w żadnym dniu.

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

Powtórzenia comiesięczne

Określa, 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 przejmowany 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 ERR

W przypadku błędu wyjście zostaje ustawione na prawdziwe. Może to być, gdy kalendarz nie istnieje lub identyfikator nie został określony lub jest nieprawidłowy.