GetTimeZoneInformationForYear 함수(timezoneapi.h)

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

구문

BOOL GetTimeZoneInformationForYear(
  [in]           USHORT                         wYear,
  [in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
  [out]          LPTIME_ZONE_INFORMATION        ptzi
);

매개 변수

[in] wYear

표준 시간대 설정을 검색할 연도입니다. wYear 매개 변수는 현지 시간 값이어야 합니다.

[in, optional] pdtzi

표준 시간대를 지정하는 DYNAMIC_TIME_ZONE_INFORMATION 구조체에 대한 포인터입니다. 이 매개 변수를 채움하려면 원하는 표준 시간대의 인덱 스로 EnumDynamicTimeZoneInformation 을 호출합니다. 이 매개 변수가 NULL이면 현재 표준 시간대가 사용됩니다.

[out] ptzi

표준 시간대 설정을 수신하는 TIME_ZONE_INFORMATION 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

wYear 매개 변수는 현지 시간 값으로 간주됩니다. 현지 시간이 이전 연도와 새해(1월 1일 00:00:00) 사이의 전환에 근접한 경우 GETTimeZoneInformationForYear 함수에 UTC 연도를 전달하면 함수가 잘못된 연도에 대한 표준 시간대 설정을 반환할 수 있습니다.

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

요구 사항

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

참고 항목

DYNAMIC_TIME_ZONE_INFORMATION

현지 시간

TIME_ZONE_INFORMATION

시간 함수