Bloc Funcțional Timeswitch_Get
Blocul funcțional TIMESWITCH_GET returnază toate informațiile unui eveniment al unei ceasuri cu comutator.
Atenție: Ceasul cu comutator trebuie să fie stocat în același element.
Intrarea Timeswitch
Aici se stochează baza de date a ceasului cu comutator ca ș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 șir de caractere al evenimentului.
Ieșirea Err
În cazul unei erori, ieșirea este setată pe adevărat. Acest lucru poate apărea dacă calendarul nu există sau dacă ID-ul nu este definit sau este invalid.
Ieșirea Title
Returnază titlul evenimentului.
Ieșirea Dt_Start
Momentul de început al evenimentului în format DT# returnat.
Ieșirea Dt_End
Momentul de sfârșit al evenimentului în format DT# returnat.
Ieșirea Dis
Dacă ieșirea este adevărată, atunci evenimentul este dezactivat și este ignorat de programul de timp.
Ieșirea Repeat
Ieșirea returnază repetările ca șir de caractere. Acestea corespund funcțiilor auxiliare REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY și REPEAT_HOURLY.
Șirul de caractere poate fi separat printr-un două puncte sau poate fi construit astfel:
w:2:4:135
Prima cifră (litera mică) definește intervalul de timp al repetării:
| Scurtătură | Interval De Timp |
|---|---|
| h | Oară pe oră |
| d | Zilnic |
| w | Săptămânal |
| m | Lunar |
| y | Anual |
A doua cifră definește intervalul ca 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 număr întreg simplu: Repetarea se termină după numărul definit de repetări.
- Ca dată YYYY-MM-DD: Repetarea se încheie î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 trebuie repetat evenimentul. Sunt suportate numere de la -1 până 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 Dt_Modify
Ieșirea definește ultima modificare în format DT#. Această intrare poate fi, de asemenea, nedefinită dacă evenimentul a fost creat înainte de versiunea 5.0.