현재 표준 시간대 설정을 검색합니다. 이러한 설정은 UTC(협정 세계시)와 현지 시간 간의 번역을 제어합니다.
해마다 변경되는 일광 절약 시간에 대한 경계를 지원하려면 GetDynamicTimeZoneInformation 또는 GetTimeZoneInformationForYear 함수를 사용합니다.
구문
DWORD GetTimeZoneInformation(
[out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);
매개 변수
[out] lpTimeZoneInformation
현재 설정을 받을 TIME_ZONE_INFORMATION 구조체에 대한 포인터입니다.
반환 값
함수가 성공하면 다음 값 중 하나를 반환합니다.
| 반환 코드/값 | 설명 |
|---|---|
|
전환 날짜가 없거나 일광 절약 시간에 대한 자동 조정이 비활성화되어 있으므로 현재 표준 시간대에서는 일광 절약 시간이 사용되지 않습니다. |
|
시스템은 TIME_ZONE_INFORMATION 구조체의 StandardDate 멤버가 적용되는 범위에서 작동합니다. |
|
시스템은 TIME_ZONE_INFORMATION 구조체의 DaylightDate 멤버가 적용되는 범위에서 작동합니다. |
메모리 부족 오류와 같은 다른 이유로 인해 함수가 실패하면 TIME_ZONE_ID_INVALID 반환됩니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
UTC 시간과 현지 시간 간의 모든 번역은 다음 수식을 기반으로 합니다.
UTC = 현지 시간 + 바이어스
편견은 UTC 시간과 현지 시간 사이의 차이(분)입니다.
결과 TIME_ZONE_INFORMATION 구조의 StandardName 및 DaylightName 멤버는 현재 사용자 기본 UI 언어에 따라 지역화됩니다.
예제
예제는 SetTimeZoneInformation을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | timezoneapi.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |