Blocco Funzionale Timeswitch_Get
Il blocco funzionale TIMESWITCH_GET restituisce tutte le informazioni di un evento di una sveglia.
Nota: La sveglia deve essere memorizzata nello stesso elemento.
Ingresso Timeswitch
Qui viene memorizzato il database dell'orologio come stringa. Questo deve già esistere come blocco funzionale TIMESWITCH. Prestare attenzione anche all'ordine del programma, affinché questo blocco funzionale venga inizializzato correttamente.
Ingresso ID
Definisce l'ID come stringa dell'evento.
Uscita ERR
In caso di errore, l'uscita viene impostata su vero. Questo può accadere se il calendario non esiste o se l'ID non è definito o è invalido.
Uscita TITLE
Restituisce il titolo dell'evento.
Uscita DT_START
Il momento di inizio dell'evento nel formato DT# restituito.
Uscita DT_END
Il momento di fine dell'evento nel formato DT# restituito.
Uscita DIS
Se l'uscita è vera, l'evento è disattivato e viene ignorato dal programma temporale.
Uscita REPEAT
L'uscita restituisce le ripetizioni come stringa. Queste corrispondono alle funzioni di supporto REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY e REPEAT_HOURLY.
La stringa può essere separata da un doppio punto o costruita come segue:
w:2:4:135
Il primo numero (in minuscolo) definisce l'intervallo di tempo della ripetizione:
| Abbreviazione | Intervallo Di Tempo |
|---|---|
| h | Ore |
| d | Giornaliero |
| w | Settimanale |
| m | Mensile |
| y | Annuale |
Il secondo numero definisce l'intervallo come intero della ripetizione. Il valore minimo è 1.
Il terzo numero definisce la fine della ripetizione. Qui possono essere definiti tre formati diversi:
- Nessun valore: La ripetizione è infinita.
- Come intero semplice: La ripetizione termina dopo il numero definito di ripetizioni.
- Come data YYYY-MM-DD: La ripetizione viene terminata prima della data.
Il quarto numero definisce i giorni della settimana in cui avviene la ripetizione. Questo numero viene utilizzato solo nella definizione delle ripetizioni settimanali o mensili.
Ripetizioni Settimanali
Viene verificato se il giorno della settimana corrente è presente nel numero. Più giorni possono essere semplicemente indicati uno dopo l'altro. Ad esempio, 135 per lunedì, mercoledì e venerdì. Se non viene specificato alcun valore (0 o una stringa vuota), la ripetizione non avviene in nessun giorno.
| Numero | Giorno Della Settimana |
|---|---|
| 1 | Lunedì |
| 2 | Martedì |
| 3 | Mercoledì |
| 4 | Giovedì |
| 5 | Venerdì |
| 6 | Sabato |
| 7 | Domenica |
Ripetizioni Mensili
Definisce in quale giorno della settimana l'evento deve essere ripetuto. Sono supportati numeri da -1 a 4. 0 o nessuna dichiarazione ripete mensilmente lo stesso giorno, indipendentemente dal giorno della settimana. Il giorno della settimana viene preso dal primo dato.
| Valore | Descrizione |
|---|---|
| -1 | Ripete l'ultimo giorno della settimana. |
| 0 | Ripete lo stesso giorno. (Predefinito) |
| 1 | Ripete il primo giorno della settimana. |
| 2 | Ripete il secondo giorno della settimana. |
| 3 | Ripete il terzo giorno della settimana. |
| 4 |
Ripete il quarto giorno della settimana. |
Uscita DT_MODIFY
L'uscita definisce l'ultima modifica nel formato DT#. Questo ingresso può anche essere indefinito se l'evento è stato creato prima della versione 5.0.