Bloc funcțional TIMESWITCH_ADD

Blocul funcțional TIMESWITCH_ADD creează sau modifica un eveniment într-un ceas cu schimbător.

Atenție: Ceasul cu schimbător trebuie să fie stocat în același element.

Sfaturi: Pentru a modifica un eveniment, toate valorile pot fi citite folosind blocul funcțional TIMESWITCH_GET.

Intrarea ADD

Intrarea creează sau modifică un eveniment în calendar, la o frontă pozitivă. Dacă intrarea este întotdeauna adevărată, atunci evenimentul, odată șters, va fi recreat. Modificările unui eveniment nu sunt detectate.

Important: Crearea și ștergerea simultană ar trebui evitată, deoarece aceasta poate solicita foarte mult SSD-ul.

Intrarea TIMESWITCH

Aici se stochează baza de date a ceasului cu schimbător ca un șir de caractere. Acesta trebuie să existe deja ca bloc funcțional TIMESWITCH. Luați în considerare și ordinea programului, astfel încât acest bloc funcțional să fie inițializat corect.

Intrarea ID

Definește ID-ul ca un șir de caractere al evenimentului. Acest lucru permite o identificare unică și previne ca alte evenimente să creeze conflicte. ID-ul ar trebui să conțină doar litere și numere. Sensibilitatea la majuscule și minuscule este respectată.

Atenție: ID-ul ar trebui definit unic pentru toate calendarele. Un eveniment poate fi copiat de utilizator pe vizualizare într-un alt calendar.

Intrarea TITLE

Titlul evenimentului ca un șir de caractere. Acesta nu ar trebui să conțină returnări la rând. Dacă intrarea ADD este adevărată, orice modificare va fi scrisă imediat în calendar.

Intrarea DT_START

Momentul de început al evenimentului în format DT# înapoi. Dacă intrarea ADD este adevărată, orice modificare va fi scrisă imediat în calendar.

Sfaturi: Timpii de comutare pot fi calculați cu blocurile funcționale MKTIME, STR2DT și EASTER_DATE.

Intrarea DT_END

Momentul de sfârșit al evenimentului în format DT# înapoi. Dacă intrarea ADD este adevărată, orice modificare va fi scrisă imediat în calendar. Dacă momentul de sfârșit este mai mic decât DT_START, atunci DT_END va fi definit ca moment de început.

Dacă intrarea nu este definită, se presupune același valor ca DT_START și se generează un impuls pentru eveniment.

Intrarea DIS

Intrarea dezactivează evenimentul în calendar. Dacă intrarea ADD este adevărată, orice modificare va fi scrisă imediat în calendar.

Intrarea REPEAT

La intrare pot fi definite repetările ca un șir de caractere. Acestea pot fi generate cu funcțiile auxiliare REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY și REPEAT_HOURLY sau declarate așa cum este descris.

Șirul de caractere poate fi construit, separat printr-un două puncte, după cum urmează:

w:2:4:135

Prima cifră (scrisă cu litere mici) definește intervalul de timp al repetării:

Scurtătură	Interval de timp
h	Orar
d	Zilnic
w	Săptămânal
m	Lunar
y	Anual

A doua cifră definește intervalul ca un număr întreg al repetării. Valoarea minimă este 1.

A treia cifră definește sfârșitul repetării. Aici pot fi definite trei formate diferite:

• Nicio valoare: Repetarea este infinită.
• Ca un număr întreg simplu: Repetarea se termină după numărul definit de repetări.
• Ca dată YYYY-MM-DD: Repetarea se termină înainte de dată.

A patra cifră definește zilele săptămânii în care are loc repetarea. Această cifră este utilizată doar la definirea repetărilor săptămânale sau lunare.

Repetări săptămânale

Se verifică dacă ziua curentă a săptămânii este prezentă în număr. Mai multe zile pot fi specificate una după alta. De exemplu, 135 pentru luni, miercuri și vineri. Dacă nu este specificată nicio valoare (0 sau un șir de caractere gol), atunci repetarea are loc în niciuna dintre zile.

Număr	Ziua săptămânii
1	Luni
2	Marți
3	Miercuri
4	Joi
5	Vineri
6	Sâmbătă
7	Duminică

Repetări lunare

Definește în ce zi a săptămânii evenimentul trebuie repetat. Sunt suportate numere de la -1 la 4. 0 sau nicio declarație repetă lunar în aceeași zi, independent de ziua săptămânii. Ziua săptămânii este preluată din prima dată.

Valoare	Descriere
-1	Repetă în ultima zi a săptămânii.
0	Repetă în aceeași zi. (Implicit)
1	Repetă în prima zi a săptămânii.
2	Repetă în a doua zi a săptămânii.
3	Repetă în a treia zi a săptămânii.
4	Repetă în a patra zi a săptămânii.

Ieșirea ERR

În caz de eroare, ieșirea este setată pe adevărat. Acest lucru poate fi dacă calendarul nu există sau ID-ul nu a fost definit sau este invalid.