Функциональный блок TIMESWITCH_GET
Функциональный блок TIMESWITCH_GET возвращает всю информацию о событии таймера.
Примечание: Таймер должен быть сохранен в том же элементе.
Вход TIMESWITCH
Здесь хранится база данных таймера как строка. Она должна существовать как функциональный блок TIMESWITCH. Учитывайте также порядок программы, чтобы этот функциональный блок был правильно инициализирован.
Вход ID
Определяет идентификатор события как строку.
Выход ERR
В случае ошибки выходной сигнал устанавливается в истину. Это может произойти, если календарь не существует или идентификатор не определен или недействителен.
Выход TITLE
Возвращает заголовок события.
Выход DT_START
Начальное время события в формате DT#.
Выход DT_END
Конечное время события в формате DT#.
Выход DIS
Если выходной сигнал истинный, то событие деактивировано и игнорируется таймером.
Выход REPEAT
Выходной сигнал возвращает повторения как строку. Они соответствуют вспомогательным функциям REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY и REPEAT_HOURLY.
Строка может быть разделена двоеточием или иметь следующий формат:
w:2:4:135
Первая цифра (строчная) определяет временной интервал повторения:
| Сокращение | Временной интервал |
|---|---|
| h | Ежечасно |
| d | Ежедневно |
| w | Еженедельно |
| m | Ежемесячно |
| y | Ежегодно |
Вторая цифра определяет интервал как целое число повторения. Минимальное значение 1.
Третья цифра определяет конец повторения. Здесь могут быть определены три различных формата:
- Нет значения: Повторение бесконечно.
- Как простое целое число: Повторение заканчивается после определенного количества повторений.
- Как дата YYYY-MM-DD: Повторение прекращается до указанной даты.
Четвертая цифра определяет дни недели, в которые происходит повторение. Эта цифра используется только при определении еженедельных или ежемесячных повторений.
Еженедельные повторения
Проверяется, содержится ли текущий день недели в числе. Несколько дней могут быть указаны подряд. Например, 135 для понедельника, среды и пятницы. Если значение не указано (0 или пустая строка), то повторение не происходит ни в один день.
| Число | День недели |
|---|---|
| 1 | Понедельник |
| 2 | Вторник |
| 3 | Среда |
| 4 | Четверг |
| 5 | Пятница |
| 6 | Суббота |
| 7 | Воскресенье |
Ежемесячные повторения
Определяет, в какой день недели должно происходить повторение события. Поддерживаются числа от -1 до 4. 0 или отсутствие объявления повторяет каждый месяц в тот же день, независимо от дня недели. День недели берется из первой даты.
| Значение | Описание |
|---|---|
| -1 | Повторяется в последний день недели. |
| 0 | Повторяется в тот же день. (По умолчанию) |
| 1 | Повторяется в первый день недели. |
| 2 | Повторяется во второй день недели. |
| 3 | Повторяется в третий день недели. |
| 4 |
Повторяется в четвертый день недели. |
Выход DT_MODIFY
Выход определяет последнее изменение в формате DT#. Этот вход также может быть неопределенным, если событие было создано до версии 5.0.