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 | 毎年 |
2番目の桁は、繰り返しの整数間隔を定義します。最小値は1です。
3番目の桁は、繰り返しの終了を定義します。ここでは3つの異なる形式を定義できます:
- 値なし: 繰り返しは無限です。
- 単純な整数として: 繰り返しは定義された回数後に終了します。
- 日付YYYY-MM-DDとして: 繰り返しはその日付の前に終了します。
4番目の桁は、繰り返しが行われる曜日を定義します。この桁は週次または月次の繰り返しを定義する際にのみ使用されます。
毎週の繰り返し
現在の曜日が数値に存在するかどうかを確認します。複数の日を連続して指定できます。例えば、135は月曜日から水曜日にかけてです。値が指定されていない場合（0または空の文字列）、繰り返しは行われません。
| 数値 | 曜日 |
|---|---|
| 1 | 月曜日 |
| 2 | 火曜日 |
| 3 | 水曜日 |
| 4 | 木曜日 |
| 5 | 金曜日 |
| 6 | 土曜日 |
| 7 | 日曜日 |
毎月の繰り返し
イベントが繰り返される曜日を定義します。-1から4までの数値がサポートされます。0または宣言なしは、曜日を考慮せずに毎月同じ日に繰り返します。曜日は最初の日付から取得されます。
| 値 | 説明 |
|---|---|
| -1 | 最後の曜日で繰り返します。 |
| 0 | 同じ日に繰り返します。（デフォルト） |
| 1 | 最初の曜日で繰り返します。 |
| 2 | 2番目の曜日で繰り返します。 |
| 3 | 3番目の曜日で繰り返します。 |
| 4 |
4番目の曜日で繰り返します。 |
出力 DT_MODIFY
この出力は、最終変更日をDT#形式で定義します。この入力は、イベントがバージョン5.0より前に作成された場合でも未定義のままであることがあります。