historicalStatusData

readData, readDataOnTime, readStatusLog, readStatusLogOnTime 를 이용한 결과값에는 해당 검색정보에 따라 상태 포인트의 이력정보가 반환됩니다. 이력정보는 historicalAnalogData 개채로 반환됩니다.

반환되는 정보에는 다수의 정보를 담고 있습니다.

데이터의 정상/비정상
순시값
On 상태 시간
Off 상태 시간
On 횟수
Off 횟수
이력저장시간

반환되는 이력정보의 시간의 주기는 readData, readDataOnTime의 경우에는 이력 데이터 그룹에 저장된 수집주기이며 readStatusLog, readStatusLogOnTime 는 type으로 선택한 시간, 일, 월, 년, 누적 중 하나입니다.

Methods

리턴 값	함 수	설 명
boolean	isGood()	취득 이력정보의 정상, 비정상 여부를 읽어옵니다.
flaot	curValue()	취득 이력정보 주기기간의 순시값을 읽어옵니다.
int	onDuration()	취득 이력정보 주기기간의 On 상태 시간을 읽어옵니다.
int	offDuration()	취득 이력정보 주기기간의 Off 상태 시간을 읽어옵니다.
int	onCount()	취득 이력정보 주기기간의 On 횟수를 읽어옵니다.
int	offCount()	취득 이력정보 주기기간의 Off 횟수를 읽어옵니다.
datetime	time()	취득 이력정보 저장시간을 읽어옵니다.

boolean isGood()

isGood()은 이력 정보의 정상, 비정상 여부를 판단할 수 있습니다.

참을 반환하면 정상 데이터입니다.
거짓을 반환하면 비정상 데이터입니다.

예)

data_list = logStatus.readData('이력 데이터 그룹1', '스테이션1.온도', st, et )

# RT에는 온도의 검색시간 최초주기의 데이터 정상/비정상이 저장됩니다.

RT = data_list[0].isGood()

float curValue()

curValue()은 이력 정보의 해당 주기의 순시값을 반환합니다.

예)

data_list = logStatus.readData('이력 데이터 그룹1', '스테이션1.전원', st, et )

# RT에는 전원의 검색시간 최초주기의 순시값이 저장됩니다.

RT = data_list[0].curVal()

int onDuration()

onDuration()은 이력 정보의 해당 주기의 On 상태의 시간을 반환합니다.

반환되는 값은 초단위로 계산된 수입니다.

예)

data_list = logStatus.readData('이력 데이터 그룹1', '스테이션1.전원', st, et )

# RT에는 전원의 검색시간 최초주기의 On 상태 시간이 초단위로 계산된 수로 저장됩니다.

RT = data_list[0].onDuration()

# 초단위 숫자를 파이썬 날짜 형식으로 변경할 수 있습니다.

tm = datetime.datetime.fromtimestamp( RT );

int offDuration()

offDuration()은 이력 정보의 해당 주기의 Off 상태의 시간을 반환합니다.

반환되는 값은 초단위로 계산된 수입니다.

예)

data = logStatus.readDataOnTime('이력 데이터 그룹1', '스테이션1.전원', time )

# RT에는 전원의 검색시간 주기의 On 상태 시간이 초단위로 계산된 수로 저장됩니다.

RT = data.offDuration()

# 초단위 숫자를 파이썬 날짜 형식으로 변경할 수 있습니다.

tm = datetime.datetime.fromtimestamp( RT );

int onCount()

onCount()는 이력 정보의 해당 주기의 on 상태로 변경된 횟수를 반환합니다.

예)

data = logStatus.readDataOnTime('이력 데이터 그룹1', '스테이션1.전원', time )

# RT에는 전원의 검색시간 주기의 On 상태로 변경된 횟수가 저장됩니다.

RT = data.onCount()

int offCount()

offCount()는 이력 정보의 해당 주기의 off 상태로 변경된 횟수를 반환합니다.

예)

data = logStatus.readDataOnTime('이력 데이터 그룹1', '스테이션1.전원', time )

# RT에는 전원의 검색시간 주기의 Off 상태로 변경된 횟수가 저장됩니다.

RT = data.offCount()

datetime time()

time()은 이력 정보의 해당 주기의 저장시간을 반환합니다.

파이썬 스크립트 datetime 개체 사용방법을 참고하세요.

예)

data_list = logStatus.readData('이력 데이터 그룹1', '스테이션1.전원', st, et )

# RT에는 전원의 검색시간 6번째 주기의 저장시간이 파이썬 datetime형식으로 저장됩니다.

RT = data_list[5].time()