GetTimeZoneInformation 함수(timezoneapi.h)

현재 표준 시간대 설정을 검색합니다. 이러한 설정은 UTC(협정 세계시)와 현지 시간 간의 번역을 제어합니다.

해마다 변경되는 일광 절약 시간에 대한 경계를 지원하려면 GetDynamicTimeZoneInformation 또는 GetTimeZoneInformationForYear 함수를 사용합니다.

구문

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

[out] lpTimeZoneInformation

현재 설정을 받을 TIME_ZONE_INFORMATION 구조체에 대한 포인터입니다.

함수가 성공하면 다음 값 중 하나를 반환합니다.

반환 코드/값	설명
TIME_ZONE_ID_UNKNOWN 0	전환 날짜가 없거나 일광 절약 시간에 대한 자동 조정이 비활성화되어 있으므로 현재 표준 시간대에서는 일광 절약 시간이 사용되지 않습니다.
TIME_ZONE_ID_STANDARD 1	시스템은 TIME_ZONE_INFORMATION 구조체의 StandardDate 멤버가 적용되는 범위에서 작동합니다.
TIME_ZONE_ID_DAYLIGHT 2	시스템은 TIME_ZONE_INFORMATION 구조체의 DaylightDate 멤버가 적용되는 범위에서 작동합니다.

메모리 부족 오류와 같은 다른 이유로 인해 함수가 실패하면 TIME_ZONE_ID_INVALID 반환됩니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

UTC 시간과 현지 시간 간의 모든 번역은 다음 수식을 기반으로 합니다.

UTC = 현지 시간 + 바이어스

편견은 UTC 시간과 현지 시간 사이의 차이(분)입니다.

결과 TIME_ZONE_INFORMATION 구조의 StandardName 및 DaylightName 멤버는 현재 사용자 기본 UI 언어에 따라 지역화됩니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	timezoneapi.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll