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 |