Blocco Funzionale Timeswitch_Add

Il blocco funzionale TIMESWITCH_ADD crea o modifica un evento in una timer switch.

Nota: La timer switch deve essere memorizzata nello stesso elemento.

Suggerimento: Per modificare un evento, tutti i valori possono essere letti utilizzando il blocco funzionale TIMESWITCH_GET.

Ingresso ADD

L'ingresso crea o modifica un evento nel calendario, su un fronte positivo. Se l'ingresso è sempre vero, l'evento viene ricreato non appena viene eliminato. Le modifiche di un evento non vengono rilevate.

Importante: La creazione e la cancellazione simultanea dovrebbero essere evitate, poiché ciò può mettere a dura prova l'SSD.

Ingresso TIMESWITCH

Qui viene memorizzato il database del timer switch come stringa di caratteri. 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 di caratteri dell'evento. Questo consente un'identificazione univoca e impedisce che altri eventi generino conflitti. L'ID dovrebbe contenere solo lettere e numeri. La maiuscola/minuscola viene considerata.

Nota: L'ID dovrebbe essere definita in modo univoco per tutti i calendari. Un evento può essere copiato dall'utente nella visualizzazione in un altro calendario.

Ingresso TITLE

Il titolo dell'evento come stringa di caratteri. Questo non dovrebbe contenere a capo. Se l'ingresso ADD è vero, ogni modifica viene scritta immediatamente nel calendario.

Ingresso DT_START

L'orario di inizio dell'evento nel formato DT# indietro. Se l'ingresso ADD è vero, ogni modifica viene scritta immediatamente nel calendario.

Suggerimento: Gli orari di commutazione possono essere calcolati con i blocchi funzionali MKTIME, STR2DT e EASTER_DATE.

Ingresso DT_END

L'orario di fine dell'evento nel formato DT# indietro. Se l'ingresso ADD è vero, ogni modifica viene scritta immediatamente nel calendario. Se l'orario di fine è inferiore a DT_START, DT_END viene definito come orario di inizio.

Se l'ingresso non viene definito, viene assunto lo stesso valore di DT_START e viene generato un impulso nell'evento.

Ingresso DIS

L'ingresso disattiva l'evento nel calendario. Se l'ingresso ADD è vero, ogni modifica viene scritta immediatamente nel calendario.

Ingresso REPEAT

All'ingresso possono essere definite le ripetizioni come stringa di caratteri. Queste possono essere generate con le funzioni di supporto REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY e REPEAT_HOURLY o dichiarate come descritto.

La stringa di caratteri può essere costruita separata da un doppio punto come segue:

w:2:4:135

Il primo numero (minuscolo) definisce l'intervallo di tempo della ripetizione:

Abbreviazione	Intervallo Di Tempo
h	Orologio
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 attuale è 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 di caratteri 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 nello stesso giorno, indipendentemente dal giorno della settimana. Il giorno della settimana viene preso dalla prima data.

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 ERR

In caso di errore, l'uscita viene impostata su vero. Questo può accadere se il calendario non esiste o se l'ID non è stata definita o è invalida.