12.1.3 관련 기능
- CIMON (Unlicensed)
- CIMON (Unlicensed)
본 항목에서는 보고서 기능에서 자주 쓰이는 함수(Function) 및 서브루틴(Subroutine)[1]을 확인할 수 있습니다. 활용할 수 있는 함수 및 서브루틴은 다음 표를 참조하여 주시기 바랍니다. 각 함수 및 서브루틴의 자세한 사항은 각 항을 참조하여 주시기 바랍니다.
명령어 | 설명 | ||
보고서 | 함수 | ReportTimeStr | 보고서용 시각을 문자열로 출력합니다. |
함수 | TLogVal | 지정한 태그의 보고서 데이터 값을 표시합니다. | |
시각 | 함수 | TimeStr | 현재의 시간을 시간 표시 형식에 맞추어 나타냅니다. |
ReportTimeStr | 보고서용 시각을 문자열로 출력합니다. | |
함수명 | 연산식 표기 | ReportTimeStr (“시각값”, 시간표시형식) |
스크립트 표기 | StrVal$ = ReportTimeStr (“시각값”, 시간표시형식) | |
기능 | 보고서 양식으로 프로젝트의 보고서를 출력할 때, 보고서에 표시될 시각을 “시간표시형식”의 값에 따라 문자열로 출력합니다. “시각값”을 음수로 표현하면 금일부터 지정된 수만큼의 전일을 표시합니다. “시각값”이 0이면 금일을 나타냅니다. | |
사용 예제 | 예1) 양식의 B4셀에 보고서의 시각을 나타내도록 합니다. ReportTimeStr(“0일”, 9) + “ “ + ReportTimeStr(“0일”, 64) 예2) 양식의 B4셀에 보고서의 요일을 나타내도록 합니다. ReportTimeStr(“0주”, 64) = 보고서 양식에 표시되는 시각의 형식: n요일 | |
TLogVal | 지정한 태그의 보고서 데이터 값을 표시합니다. | |
함수명 | 연산식 표기 | TLogVal (“태그 이름”, “시각값”, “값종류”) |
스크립트 표기 | n = TLogVal (“태그 이름”, “시각값”, “값종류”) | |
기능 | 각 태그 이름이 등록된 보고서 데이터에서, “시각값”에 해당하는 시간대에 보고서에 기록된 데이터의 값을 값종류에 따라 표시합니다. 이 때, 태그는 보고서용 태그로 지정되어야 합니다. | |
사용 예제 | 전일 2시부터 3시까지 발전기 태그의 값의 증가량을 확인합니다. TLogVal (“발전기”, “-1일3시”, “적산합”) = n | |
아날로그 태그의 값종류 | 디지털 태그의 값종류 | ||
순간값 | 지정된 시각에 입력된 태그값 | 가동시간n | n번째 가동시간(일보) |
평균값 | 각 일별/월별/연도별 평균값 | 가동시간 | 지정된 시각값의 가동시간 합계값 |
적산값 | 지정된 시각에 증가한 값 | 가동횟수 | 지정된 시각값의 가동횟수 |
순간합 | 각 시간대별 순간값의 합 | 가동시간합 | 지정된 시각값의 가동시간 합계값 |
순간평균 | 각 시간대별 순간값의 평균 | 가동시간평균 | 일별/월별 가동시간 평균값 |
순간최소 | 각 시간대별 순간값의 최솟값 | 가동시간최소 | 일별/월별 가동시간 최솟값 |
순간최대 | 각 시간대별 순간값의 최댓값 | 가동시간최대 | 일별/월별 가동시간 최댓값 |
순간최소시간 | 순간최솟값이 발생한 시각 | 가동최소시간 | 가동시간이 최소인 일/요일/월 |
순간최대시간 | 순간최댓값이 발생한 시각 | 가동최대시간 | 가동시간이 최대인 일/요일/월 |
적산합 | 각 시간대별 적산값의 합 | 가동횟수합 | 월/주/년의 총 가동횟수 |
적산평균 | 각 시간대별 적산값의 평균 | 가동횟수평균 | 일별/월별 가동횟수 평균 |
적산최소 | 각 시간대별 적산값의 최솟값 | 가동횟수최소 | 일별/월별 가동 횟수 중 최솟값 |
적산최대 | 각 시간대별 적산값의 최댓값 | 가동횟수최대 | 일별/월별 가동 횟수 중 최댓값 |
적산최소시간 | 적산최솟값이 발생한 시각 | 가동횟수최소시간 | 일별/월별 가동횟수가 최소인 일/요일/월 |
적산최대시간 | 적산최대값이 발생한 시각 | 가동횟수최대시간 | 일별/월별 가동횟수가 최대인 일/요일/월 |
(1) 아날로그 태그의 보고서용 시각값과 값 종류
시각값 | 내용 | 설정범위 | 적용되는 값종류 |
hh시 | 금일의 시각을 표시합니다. | "0시" ~ "23시" | 순간값, 적산값 |
dd일hh시 | 지정된 날짜의 지정된 시각을 표시합니다. "0일"이면 금일, "-1일"이면 전일을 의미합니다. | hh시: dd일: "-2일"~"0일" | 순간값, 적산값 |
dd일 | 금월의 날짜를 표시합니다. 음수인 경우에는 금일부터 지정된 수만큼 전일을 표시합니다. | "1일"~"31일" | 순간값, 평균값, 적산값 |
"-2일"~"0일" | 순간합, 순간평균, 순간최소, 순간최대, 순간최소시간, 순간최대시간, 적산합, 적산평균, 적산최소, 적산최대, 적산최소시간, 적산최대시간 | ||
mm월dd일 | 지정된 월의 특정 날짜를 표시합니다. "1월"에서 "12월"은 금년의 특정 월을 표시합니다. 월이 음수인 경우, 지정된 월만큼 이전 월을 표시합니다. | dd일: "1일"~"31일" mm월: "2월"~"0월" | 순간값, 평균값, 적산값 |
mm월 | 금년의 월을 표시합니다. "1월"~"12월"은 금년의 특정 월을 표시합니다. 월이 음수일 경우, 지정된 월만큼 이전 월을 표시합니다. | "1월"~"12월" | 순간값, 평균값, 적산값 |
"-2월"~"0월" | 순간합, 순간평균, 순간최소, 순간최대, 순간최소시간, 순간최대시간, 적산합, 적산평균, 적산최소, 적산최대, 적산최소시간, 적산최대시간 | ||
yy년mm월 | 지정된 연도의 특정 월을 표시합니다. 연도가 음수일 경우, 지정된 연도만큼 이전년도를 표시합니다. "-1일년"은 어제의 연도를 의미합니다. "-1월년"은 지난달의 연도를 의미합니다. | mm월: "1월"~"12월" yy년: "-9년"~"2038년" | 순간값, 평균값, 적산값 |
yy년 | 지정된 연도를 표시합니다. "년"으로 입력하면 금년을 의미합니다. "-1일년"은 전일의 연도를 의미합니다. "-1월년"은 지난달의 연도를 의미합니다. | "-9년"~"2038년" | 순간값, 평균값, 적산값 순간합, 순간평균, 순간최소, 순간최대, 순간최소시간, 순간최대시간, 적산합, 적산평균, 적산최소, 적산최대, 적산최소시간, 적산최대시간 |
w요일 | 금주의 특정 요일을 표시합니다. | "일요일"~"토요일" | 순간값, 평균값, 적산값 |
n주w요일 | 지정된 주의 특정 요일을 표시합니다. 0이면 금주를, 음수이면 해당 숫자 만큼 전주를 표시합니다. | w요일: "일요일"~"토요일" n주: "-5주"~ "0주" | 순간값, 평균값, 적산값 |
n주 | 지정된 주를 표시합니다. 0이면 금주를, 음수이면 해당 숫자만큼 전주를 표시합니다. "-1일주"는 전일의 주를 표시합니다. | "-5주" ~ "0주" | 순간합, 순간평균, 순간최소, 순간최대, 순간최소시간, 순간최대시간, 적산합, 적산평균, 적산최소, 적산최대, 적산최소시간, 적산최대시간 |
(2) 적용범위
일보인 경우 | "0시" ~ "23시" | 순간값,적산값 | 금일 |
"-1일0시"~ "-2일23시" | 전일 ~ 전전일 | ||
"일" | 순간합, 순간평균, 순간최소, 순간최대, 순간최소시간, 순간최대시간, 적산합, 적산평균, 적산최소, 적산최대, 적산최소시간, 적산최대시간 | 금일 | |
"-1일","-2일" | 전일 ~ 전전일 | ||
월보인 경우 | "1일" ~ "31일" | 순간값, 평균값, 적산값 | 금월 |
"-1월1일"~ -2월31일" | 전월 ~ 전전월 | ||
"월" | 순간합, 순간평균, 순간최소, 순간최대, 순간최소시간, 순간최대시간, 적산합, 적산평균, 적산최소, 적산최대, 적산최소시간, 적산최대시간 | 금월 | |
"-1월"~"-2월" | 전월 ~ 전전월 | ||
연보인 경우 | "1월" ~ "12월" | 순간값, 평균값, 적산값 | 금년 |
"-1년1월"~ "-9년12월" | 전년 ~ 9년전 | ||
"년" | 순간합, 순간평균, 순간최소, 순간최대, 순간최소시간, 순간최대시간, 적산합, 적산평균, 적산최소, 적산최대, 적산최소시간, 적산최대시간 | 금년 | |
"-1년"~"-9년" | 전년 ~ 9년전 | ||
주보인 경우 | "일요일"~"토요일" | 순간값, 평균값, 적산값 | 금주 |
"-1주일요일"~"-5주토요일" | 전주 ~ 5주전 | ||
"주" | 순간합, 순간평균, 순간최소, 순간최대, 순간최소시간, 순간최대시간, 적산합, 적산평균, 적산최소, 적산최대, 적산최소시간, 적산최대시간 | 금주 | |
"-1주"~"-5주" | 전주 ~5주전 |
(3) 디지털 태그의 보고서용 시각값과 값종류
시각값 | 내용 | 설정범위 | 적용되는 값종류 |
hh시 | 금일의 시각을 표시합니다. | "0시"~"23시" | 가동시간 |
dd일hh시 | 지정된 날짜의 지정된 시각을 표시합니다. "0일"이면 금일, "-1일"이면 전일을 의미합니다. | hh시: dd일: "-2일"~"0일" | 가동시간 |
dd일 | 금월의 날짜를 표시합니다. 음수인 경우에는 금일부터 지정된 수만큼 전일을 표시합니다 | "1일"~"31일" | 가동시간, 가동횟수 |
"-2일"~"0일" | 가동시간n, 가동시간, 가동횟수 | ||
mm월dd일 | 지정된 월의 특정 날짜를 표시합니다. "1월"~"12월"은 금년의 특정 월을 표시합니다. 월이 음수일 경우, 지정된 월만큼 이전 월을 표시합니다. "-1월"은 1개월 전을 의미합니다. | dd일: "1일"~"31일" mm월: "2월"~"0월" | 가동시간, 가동횟수 |
mm월 | 금년의 월을 표시합니다. "1월"~"12월"은 금년의 특정월을 표시합니다. 월이 음수일 경우, 지정된 월만큼 이전 월을 표시합니다. "-1일월"은 전일의 월을 의미합니다. | "1월"~"12월" | 가동시간, 가동횟수 |
"-2월"~"0월" | 가동시간합, 가동시간평균, 가동시간최소, 가동시간최대, 가동최소시간, 가동최대시간, 가동횟수합, 가동횟수평균, 가동횟수최소, 가동횟수최대, 가동횟수최소시간, 가동횟수최대시간 | ||
yy년mm월 | 지정된 연도의 특정 월을 표시합니다. 연도가 음수일 경우, 지정된 연도만큼 이전년도를 표시합니다. "-1일년"은 전일의 연도를 의미합니다. "-1월년"은 지난달의 연도를 의미합니다. | mm월: "1월"~"12월" yy년: | 가동시간, 가동횟수 |
yy년 | 지정된 연도를 표시합니다. "년"으로 입력하면 금년을 의미합니다. "-1일년"은 전일의 연도를 의미합니다. "-1월년" 지난달의 연도를 의미합니다. | "-9년"~"2038년" | 가동시간, 가동횟수, 가동시간합, 가동시간평균, 가동시간최소, 가동시간최대, 가동최소시간, 가동최대시간, 가동횟수합, 가동횟수평균, 가동횟수최소, 가동횟수최대, 가동횟수최소시간, 가동횟수최대시간 |
w요일 | 금주의 특정 요일을 표시합니다. | "일요일"~"토요일" | 가동시간, 가동횟수 |
n주w요일 | 지정된 주의 특정 요일을 표시합니다. 0이면 금주를, 음수이면 해당 숫자 만큼 전주를 표시합니다. | w요일 : "일요일"~"토요일" n주: "-5주"~ "0주" | 가동시간, 가동횟수 |
n주 | 지정된 주를 표시합니다. 0이면 금주를, 음수이면 해당 숫자만큼 전주를 표시합니다. "-1일주"는 1주일 전을 표시합니다. | "-5주" ~ "0주" | 가동시간합, 가동시간평균, 가동시간최소, 가동시간최대, 가동최소시간, 가동최대시간, 가동횟수합, 가동횟수평균, 가동횟수최소, 가동횟수최대, 가동횟수최소시간, 가동횟수최대시간 |
(4) 적용 범위
일보인 경우 | "0시"~"23시" | 가동시간 | 금일 |
"-1일0시"~"-2일23시" | 전일 ~ 전전일 | ||
"일" | 가동시간n, 가동시간, 가동횟수 | 금일 | |
"-1일" ~ "-2일" | 전일 ~ 전전일 | ||
월보인 경우 | "1일" ~ "31일" | 가동시간, 가동횟수 | 금월 |
"-1월1일" ~ "-2월31일" | 전월 ~ 전전월 | ||
"월" | 가동시간합, 가동시간평균, 가동시간최소, 가동시간최대, 가동횟수합, 가동횟수평균, 가동횟수최소, 가동횟수최대, 가동횟수최소시간, 가동횟수최대시간 | 금월 | |
"-1월" ~ "-2월" | 전월 ~ 전전월 | ||
연보인 경우 | "1월" ~ "12월" | 가동시간, 가동횟수 | 금년 |
"-1년1월" ~ "-9년12월" | 전년 ~ 9년전 | ||
"년" | 가동시간합, 가동시간평균, 가동시간최소, 가동시간최대, 가동횟수합, 가동횟수평균, 가동횟수최소, 가동횟수최대, 가동횟수최소시간, 가동횟수최대시간 | 금년 | |
"-1년" ~ "-9년" | 전년 ~ 9년전 | ||
주보인 경우 | "일요일" ~ "토요일" | 가동시간, 가동횟수 | 금주 |
"-1주일요일"~"-5주토요일" | 전주 ~ 5주전 | ||
"주" | 가동시간합, 가동시간평균, 가동시간최소, 가동시간최대, 가동횟수합, 가동횟수평균, 가동횟수최소, 가동횟수최대, 가동횟수최소시간, 가동횟수최대시간 | 금주 | |
"-1주" ~ "-5주" | 전주 ~ 5주전 |
시각함수
TimeStr | 현재의 시간을 시간 표시 형식에 맞추어 나타냅니다. | |
함수명 | 연산식 표기 | TimeStr (시간표시형식) |
스크립트 표기 | StrVal$ = TimeStr (시간표시형식) | |
기능 | 현재의 시간을 지정된 시간표시형식에 따라 아래 표와 같은 문자열로 출력합니다. | |
사용 예제 | 명령식으로 현재의 연도, 월, 일을 출력합니다. TimeStr (9) = yy년 mm월 dd일 | |
0 | HH:MM | 33 | yyyy/mm/dd HH:MM:SS |
1 | HH:MM AM/PM | 34 | yyyy/mm/dd HH:MM:SS AM/PM |
2 | HH:MM:SS | 35 | yyyy-mm-dd HH:MM |
3 | HH:MM:SS AM/PM | 36 | yyyy-mm-dd HH:MM AM/PM |
4 | HH시MM분 | 37 | yyyy-mm-dd HH:MM:SS |
5 | HH시MM분SS초 | 38 | yyyy-mm-dd HH:MM:SS AM/PM |
6 | mm월dd일 | 39 | mm월dd일 HH시MM분 |
7 | mm/dd | 40 | mm월dd일 HH시MM분SS초 |
8 | mm-dd | 41 | yy년mm월dd일 HH시MM분 |
9 | yy년mm월dd일 | 42 | yy년mm월dd일 HH시MM분SS초 |
10 | yy/mm/dd | 43 | yyyy년mm월dd일 HH시MM분 |
11 | yy-mm-dd | 44 | yyyy년mm월dd일 HH시MM분SS초 |
12 | yyyy년mm월dd일 | 45 | yy/mm |
13 | yyyy/mm/dd | 46 | yy년mm월 |
14 | yyyy-mm-dd | 47 | yyyy/mm |
15 | mm/dd HH:MM | 48 | yyyy년mm월 |
16 | mm/dd HH:MM AM/PM | 49 | yy |
17 | mm/dd HH:MM:SS | 50 | yyyy |
18 | mm/dd HH:MM:SS AM/PM | 51 | mm |
19 | mm-dd HH:MM | 52 | dd |
20 | mm-dd HH:MM AM/PM | 53 | HH |
21 | mm-dd HH:MM:SS | 54 | MM |
22 | mm-dd HH:MM:SS AM/PM | 55 | SS |
23 | yy/mm/dd HH:MM | 56 | yy년 |
24 | yy/mm/dd HH:MM AM/PM | 57 | yyyy년 |
25 | yy/mm/dd HH:MM:SS | 58 | mm월 |
26 | yy/mm/dd HH:MM:SS AM/PM | 59 | dd일 |
27 | yy-mm-dd HH:MM | 60 | HH시 |
28 | yy-mm-dd HH:MM AM/PM | 61 | MM분 |
29 | yy-mm-dd HH:MM:SS | 62 | SS초 |
30 | yy-mm-dd HH:MM:SS AM/PM | 63 | "일" ~ "토" |
31 | yyyy/mm/dd HH:MM | 64 | "일요일" ~ "토요일" |
32 | yyyy/mm/dd HH:MM AM/PM | 65 | "SUN" ~ "SAT" |