Bloque de funciones TIMESWITCH_GET
El bloque de funciones TIMESWITCH_GET devuelve toda la información de un evento de un reloj programador.
Nota: El reloj programador debe estar guardado en el mismo elemento.
Entrada TIMESWITCH
Aquí se guarda la base de datos del reloj como una cadena de caracteres. Esta debe existir ya 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.
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.
Salida TITLE
Devuelve el título del evento.
Salida DT_START
El momento de inicio del evento en formato DT#.
Salida DT_END
El momento de finalización del evento en formato DT#.
Salida DIS
Si la salida es verdadera, el evento está desactivado y se ignora por el programa de tiempo.
Salida REPEAT
La salida devuelve las repeticiones como una cadena de caracteres. Estas corresponden a las funciones auxiliares REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY y REPEAT_HOURLY.
La cadena de caracteres puede estar separada por un doble punto o tener la siguiente estructura:
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 número 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í se pueden definir tres formatos diferentes:
- Sin valor: La repetición es infinita.
- Como un número entero simple: La repetición termina después del número definido de repeticiones.
- Como fecha AAAA-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 comprueba 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), no se repite 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 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 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 DT_MODIFY
La salida define el último cambio en formato DT#. Esta entrada también puede estar indefinida si el evento se creó antes de la versión 5.0.