VariantTimeToSystemTime 함수(oleauto.h)

시간의 변형 표현을 시스템 시간 값으로 변환합니다.

구문

INT VariantTimeToSystemTime(
  [in]  DOUBLE       vtime,
  [out] LPSYSTEMTIME lpSystemTime
);

매개 변수

[in] vtime

변환할 변형 시간입니다.

[out] lpSystemTime

시스템 시간을 받습니다.

반환 값

함수는 성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다.

설명

변형 시간은 100년 1월 1일부터 9999년 12월 31일 사이의 날짜를 나타내는 8 바이트 실수 값(double)으로 저장됩니다. 값 2.0은 1900년 1월 1일을 나타냅니다. 3.0은 1900년 1월 2일 등을 나타냅니다. 값에 1을 추가하면 날짜가 1일씩 증가합니다. 값의 소수 부분은 하루 중 시간을 나타냅니다. 따라서 2.5는 1900년 1월 1일 정오를 나타냅니다. 3.25는 1900년 1월 2일 오전 6:00 등을 나타냅니다. 음수는 1899년 12월 30일 이전 날짜를 나타냅니다.

SYSTEMTIME 구조를 사용하는 것은 다음과 같은 이유로 유용합니다.

• 모든 시간/날짜 기간에 걸쳐 있습니다. MS-DOS 날짜/시간은 1980년 1월 1일부터 2107년 12월 31일 사이의 날짜만 나타내는 것으로 제한됩니다.
• 날짜/시간 요소는 비트 디코딩을 수행할 필요 없이 모두 쉽게 액세스할 수 있습니다.
• 국가별 언어 지원 데이터 및 시간 서식 함수 GetDateFormat 및 GetTimeFormat 은 SYSTEMTIME 값을 입력으로 사용합니다.
• Windows NT 및 Windows 95에서 지원하는 기본 Win32 시간 및 날짜 데이터 형식입니다.

VariantTimeToSystemTime 함수는 잘못된 날짜를 수락하고 VARIANT 시간으로 확인할 때 수정하려고 합니다. 예를 들어 2001년 2월 29일과 같은 잘못된 날짜는 2001년 3월 1일로 resolve. 일만 수정되므로 월 값이 잘못되면 오류가 반환됩니다. 일수는 1에서 31 사이로 확인됩니다. 음수일 및 일수가 31일보다 크면 오류가 발생합니다. 31보다 작지만 해당 월의 최대 날짜보다 큰 날은 다음 달의 적절한 날로 승격됩니다. 0과 같은 날은 이전 달의 마지막 날로 확인됩니다. 예를 들어 2001년 2월 0일과 같은 잘못된 날짜는 2001년 1월 31일로 resolve.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	oleauto.h
라이브러리	OleAut32.lib
DLL	OleAut32.dll