
功能块 TIMESWITCH_GET 返回时间开关的事件的所有信息。
注意: 时间开关必须在同一元素中存储。
在此处将时钟数据库作为字符串存储。 它必须已存在为功能块 TIMESWITCH。 请注意程序的顺序,以便正确初始化此功能块。
定义事件的ID作为字符串。
在发生错误时,将输出设置为真。 这可以是日历不存在或ID未定义或无效时。
返回事件的标题。
以格式 DT# 返回事件的开始时间点。
以格式 DT# 返回事件的结束时间点。
如果输出为真,则事件被禁用并被时间程序忽略。
输出以字符串形式返回重复次数。 它们对应于辅助功能 REPEAT_YEARLY、REPEAT_MONTHLY、REPEAT_WEEKLY、REPEAT_DAILY 和 REPEAT_HOURLY。
字符串可以用双冒号分隔或如下构建:
w:2:4:135
第一个数字(小写)定义重复的时间间隔:
| 缩写 | 时间间隔 |
|---|---|
| h | 每小时 |
| d | 每天 |
| w | 每周 |
| m | 每月 |
| y | 每年 |
第二个数字定义重复的整数间隔。 最小值为 1。
第三个数字定义重复的结束。 这里可以定义三种不同的格式:
第四个数字定义重复发生的星期几。 此数字仅用于定义每周或每月重复时使用。
检查当前星期是否存在于数字中。 可以简单地连续指定多个天。 例如,135 用于星期一、星期三和星期五。 如果未指定值(0 或空字符串),则不在任何一天重复。
| 数字 | 星期几 |
|---|---|
| 1 | 星期一 |
| 2 | 星期二 |
| 3 | 星期三 |
| 4 | 星期四 |
| 5 | 星期五 |
| 6 | 星期六 |
| 7 | 星期日 |
定义事件应在哪个星期几重复。 支持的数字范围是 -1 到 4。 0 或未声明每月在同一天重复,与星期几无关。 星期几从第一个日期获取。
| 值 | 描述 |
|---|---|
| -1 | 在最后一个星期几重复。 |
| 0 | 在同一天重复。(默认) |
| 1 | 在第一个星期几重复。 |
| 2 | 在第二个星期几重复。 |
| 3 | 在第三个星期几重复。 |
| 4 |
在第四个星期几重复。 |
输出定义最后一次更改的格式 DT#。 此输入也可以未定义,如果事件是在版本5.0之前创建的。