Функціональний блок TIMESWITCH_GET
Функціональний блок TIMESWITCH_GET повертає всю інформацію про подію таймера.
Примітка: Таймер повинен бути збережений у тому ж елементі.
Вхід TIMESWITCH
Тут зберігається база даних таймера як рядок. Він має існувати як функціональний блок TIMESWITCH. Зверніть увагу також на порядок програми, щоб цей функціональний блок правильно ініціалізувався.
Вхід ID
Визначає ID як рядок події.
Вихід ERR
У разі помилки вихід встановлюється на правду. Це може статися, якщо календар не існує або ID не визначено або неправильно.
Вихід 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.