TIGetTimeRecord

TIGetTimeRecord 함수는 지정한 GSTime을 지정한 시간 structure로 변환합니다.

GSErr TIGetTimeRecord(
  GSTime                gsTime,            // 변환할 시간
  GSTimeRecord          *pTimeRecord,      // 변환된 시간 structure를 수신하는 버퍼
  GSFlags               formatFlags        // 변환 속성들
);

 

파라미터

gsTime

변환할 시간 변수를 지정합니다. formatFlags 파라미터를 TI_CURRENT_TIME flag로 세트했을 때, gsTime 파라미터는 무시합니다.

pTimeRecord

변환 결과를 수신하는 버퍼를 지정합니다.

formatFlags

어떻게 변환할지를 지정합니다. 이 파라미터는 다음 값들의 조합이 될 수 있습니다:

값	의미
TI_LOCAL_TIME	로컬 시간
TI_UTC_TIME	UTC 시간
TI_CURRENT_TIME	현재 시간 (UTC 또는 로컬)

만약 TI_CURRENT_TIME flag를 지정하면, gsTime 파라미터는 무시합니다.

현재 로컬 또는 UTC 시간을 가져오기 위해 TI_LOCAL_TIME 또는 TI_UTC_TIME flag를 TI_CURRENT_TIME flag와 함께 조합될 수 있습니다.

리턴 값

리턴 값은 오류 코드를 이용하여 변환 성공 여부를 표시합니다. 오류 코드들에 대한 더 많은 정보에 대해서는 GSRoot 오류 코드들을 보십시오.

만약 TI_CURRENT_TIME flag를 formatFlags로 지정하면, 이 함수는 현재 시간을 가져오기 위해 TIGetTime 함수를 호출하고 gsTime 파라미터의 값을 무시합니다.

설명

만약 반대 방향으로 변환하고 싶다면, TIGetGSTime을 호출하십시오.

요구사항

    헤더: GSTime.hpp에서 선언됨
    라이브러리 가져오기: GSRootImp.lib과 링크

참고사항

Date & Time 관리자 Simple 타입, Date & Time 관리자 Structures, Date & Time 관리자 함수, TIGetGSTime