TIMESWITCH_GET 함수 블록
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 | 매년 |
두 번째 숫자는 반복 간격을 정수로 정의합니다. 최소 값은 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 전에 생성된 경우입니다.