Bloque de funciones TIMESWITCH_ADD
El bloque de funciones TIMESWITCH_ADD crea o modifica un evento en un reloj programable.
Nota: El reloj programable debe estar almacenado en el mismo elemento.
Consejo: Para modificar un evento, todos los valores pueden leerse utilizando el bloque de funciones TIMESWITCH_GET.
Entrada ADD
La entrada crea o modifica un evento en el calendario, con un flanco positivo. Si la entrada es siempre verdadera, se vuelve a crear el evento tan pronto como este sea eliminado. Los cambios de un evento no son reconocidos.
Importante: Se debe evitar la creación y eliminación simultánea, ya que esto puede poner mucha presión en la SSD.
Entrada TIMESWITCH
Aquí se almacena la base de datos del reloj programable como una cadena de caracteres. Esta debe existir previamente como bloque de funciones TIMESWITCH. Tenga en cuenta también el orden del programa, para que este bloque de funciones se inicialice correctamente.
Entrada ID
Define la ID como una cadena de caracteres del evento. Esto permite una identificación única y evita que otros eventos generen un conflicto. La ID debe consistir solo en letras y números. Se tiene en cuenta la distinción entre mayúsculas y minúsculas.
Nota: La ID debe estar definida de manera única para todos los calendarios. Un evento puede ser copiado por el usuario a otro calendario en la visualización.
Entrada TITLE
El título del evento como una cadena de caracteres. Este no debe contener saltos de línea. Si la entrada ADD es verdadera, cada cambio se escribe inmediatamente en el calendario.
Entrada DT_START
El punto de inicio del evento en el formato DT#. Si la entrada ADD es verdadera, cada cambio se escribe inmediatamente en el calendario.
Consejo: Los tiempos de conmutación pueden calcularse con los bloques de funciones MKTIME, STR2DT y EASTER_DATE.
Entrada DT_END
El punto final del evento en el formato DT#. Si la entrada ADD es verdadera, cada cambio se escribe inmediatamente en el calendario. Si el punto final es menor que DT_START, entonces DT_END se define como el punto de inicio.
Si la entrada no está definida, se asume el mismo valor que DT_START y se genera un pulso en el evento.
Entrada DIS
La entrada desactiva el evento en el calendario. Si la entrada ADD es verdadera, cada cambio se escribe inmediatamente en el calendario.
Entrada REPEAT
En la entrada pueden definirse las repeticiones como una cadena de caracteres. Estas pueden generarse con las funciones auxiliares REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY y REPEAT_HOURLY o declararse como se describe.
La cadena de caracteres puede construirse separada por dos puntos de la siguiente manera:
w:2:4:135
El primer dígito (en minúscula) define el intervalo de tiempo de la repetición:
| Abreviatura | Intervalo de tiempo |
|---|---|
| h | Por hora |
| d | Diario |
| w | Semanal |
| m | Mensual |
| y | Anual |
El segundo dígito define el intervalo como un entero de la repetición. El valor más pequeño es 1.
El tercer dígito define el final de la repetición. Aquí pueden definirse tres formatos diferentes:
- Sin valor: La repetición es infinita.
- Como un entero simple: La repetición termina después del número definido de repeticiones.
- Como una fecha YYYY-MM-DD: La repetición se detiene antes de la fecha.
El cuarto dígito define los días de la semana en los que ocurre la repetición. Este dígito solo se utiliza al definir repeticiones semanales o mensuales.
Repeticiones semanales
Se verifica si el día de la semana actual está presente en el número. Varios días pueden especificarse simplemente uno tras otro. Por ejemplo, 135 para lunes, miércoles y viernes. Si no se especifica ningún valor (0 o una cadena de caracteres vacía), la repetición no ocurre en ningún día.
| Número | Día de la semana |
|---|---|
| 1 | Lunes |
| 2 | Martes |
| 3 | Miércoles |
| 4 | Jueves |
| 5 | Viernes |
| 6 | Sábado |
| 7 | Domingo |
Repeticiones mensuales
Define en qué día de la semana debe repetirse el evento. Se admiten números de -1 a 4. 0 o ninguna declaración repite cada mes en el mismo día, independientemente del día de la semana. El día de la semana se toma del primer día.
| Valor | Descripción |
|---|---|
| -1 | Repite en el último día de la semana. |
| 0 | Repite en el mismo día. (Predeterminado) |
| 1 | Repite en el primer día de la semana. |
| 2 | Repite en el segundo día de la semana. |
| 3 | Repite en el tercer día de la semana. |
| 4 | Repite en el cuarto día de la semana. |
Salida ERR
En caso de error, la salida se establece en verdadero. Esto puede ocurrir si el calendario no existe o si la ID no está definida o es inválida.