功能块 TIMESWITCH_GET

功能块 TIMESWITCH_GET 返回时间开关的事件的所有信息。

注意: 时间开关必须在同一元素中存储。

输入 TIMESWITCH

在此处将时钟数据库作为字符串存储。 它必须已存在为功能块 TIMESWITCH。 请注意程序的顺序,以便正确初始化此功能块。

输入 ID

定义事件的ID作为字符串。

输出 ERR

在发生错误时,将输出设置为真。 这可以是日历不存在或ID未定义或无效时。

输出 TITLE

返回事件的标题。

输出 DT_START

以格式 DT# 返回事件的开始时间点。

输出 DT_END

以格式 DT# 返回事件的结束时间点。

输出 DIS

如果输出为真,则事件被禁用并被时间程序忽略。

输出 REPEAT

输出以字符串形式返回重复次数。 它们对应于辅助功能 REPEAT_YEARLYREPEAT_MONTHLYREPEAT_WEEKLYREPEAT_DAILYREPEAT_HOURLY

字符串可以用双冒号分隔或如下构建:

w:2:4:135

第一个数字(小写)定义重复的时间间隔:

缩写 时间间隔
h 每小时
d 每天
w 每周
m 每月
y 每年

第二个数字定义重复的整数间隔。 最小值为 1

第三个数字定义重复的结束。 这里可以定义三种不同的格式:

  • 无值:重复是无限的。
  • 作为简单整数:重复在定义的重复次数后结束。
  • 作为日期 YYYY-MM-DD:重复在日期之前结束。

第四个数字定义重复发生的星期几。 此数字仅用于定义每周或每月重复时使用。

每周重复

检查当前星期是否存在于数字中。 可以简单地连续指定多个天。 例如,135 用于星期一、星期三和星期五。 如果未指定值(0 或空字符串),则不在任何一天重复。

数字 星期几
1 星期一
2 星期二
3 星期三
4 星期四
5 星期五
6 星期六
7 星期日
每月重复

定义事件应在哪个星期几重复。 支持的数字范围是 -140 或未声明每月在同一天重复,与星期几无关。 星期几从第一个日期获取。

描述
-1 在最后一个星期几重复。
0 在同一天重复。(默认)
1 在第一个星期几重复。
2 在第二个星期几重复。
3 在第三个星期几重复。
4

在第四个星期几重复。

输出 DT_MODIFY

输出定义最后一次更改的格式 DT#。 此输入也可以未定义,如果事件是在版本5.0之前创建的。