功能區塊 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 之前建立的話。