功能區塊 TIMESWITCH_ADD

功能區塊 TIMESWITCH_ADD 創建或修改時間開關中的一個事件。

注意： 時間開關必須在同一元素中存儲。

提示： 要修改事件，可以使用功能區塊 TIMESWITCH_GET 讀取所有值。

輸入 ADD

輸入在正邊緣時會創建或修改日曆中的一個事件。如果輸入始終為真，則刪除該事件後將再次創建它。不會檢測到對事件的更改。

重要： 創建和同時刪除應避免，因為這可能會對 SSD 造成很大壓力。

輸入 TIMESWITCH

此處將時間開關的數據庫存儲為字符串。該數據庫必須作為功能區塊 TIMESWITCH 已經存在。請注意程序的順序，以便正確初始化此功能區塊。

輸入 ID

定義事件的 ID 作為字符串。這使得唯一識別成為可能，並防止其他事件產生衝突。ID 只應由字母和數字組成。區分大小寫。

注意： ID 應對所有日曆進行唯一定義。用戶可以在可視化界面中將事件複製到另一個日曆中。

輸入 TITLE

事件的標題作為字符串。該標題不應包含換行符。如果輸入 ADD 為真，則每次更改將立即寫入日曆。

輸入 DT_START

事件的開始時間點以 DT# 格式返回。如果輸入 ADD 為真，則每次更改將立即寫入日曆。

提示： 開關時間可以使用功能區塊 MKTIME、STR2DT 和 EASTER_DATE 計算。

輸入 DT_END

事件的結束時間點以 DT# 格式返回。如果輸入 ADD 為真，則每次更改將立即寫入日曆。如果結束時間小於 DT_START，則定義 DT_END 作為開始時間點。

如果未定義該輸入，則假設與 DT_START 相同的值，並在事件中產生一個脈衝。

輸入 DIS

輸入在日曆中停用事件。如果輸入 ADD 為真，則每次更改將立即寫入日曆。

輸入 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	在第四個星期幾重複。

輸出 ERR

在錯誤情況下，輸出被設置為真。這可以是日曆不存在或 ID 未定義或無效的原因。