TIME_ZONE_INFORMATION 구조체(timezoneapi.h)
표준 시간대에 대한 설정을 지정합니다.
구문
typedef struct _TIME_ZONE_INFORMATION {
LONG Bias;
WCHAR StandardName[32];
SYSTEMTIME StandardDate;
LONG StandardBias;
WCHAR DaylightName[32];
SYSTEMTIME DaylightDate;
LONG DaylightBias;
} TIME_ZONE_INFORMATION, *PTIME_ZONE_INFORMATION, *LPTIME_ZONE_INFORMATION;
멤버
Bias
이 컴퓨터의 현지 시간 변환에 대한 현재 편차(분)입니다. 바이어스는 UTC(협정 세계시)와 현지 시간 간의 차이(분)입니다. UTC와 현지 시간 간의 모든 번역은 다음 수식을 기반으로 합니다.
UTC = 현지 시간 + 바이어스
이 멤버는 필수입니다.
StandardName[32]
표준 시간에 대한 설명입니다. 예를 들어 "EST"는 동부 표준시를 나타낼 수 있습니다. 문자열은 GetTimeZoneInformation 함수에 의해 변경되지 않고 반환됩니다. 이 문자열은 비어 있을 수 있습니다.
StandardDate
이 운영 체제에서 일광 절약 시간에서 표준 시간으로의 전환이 발생하는 날짜 및 현지 시간을 포함하는 SYSTEMTIME 구조체입니다. 표준 시간대가 일광 절약 시간을 지원하지 않거나 호출자가 일광 절약 시간을 사용하지 않도록 설정해야 하는 경우 SYSTEMTIME 구조의 wMonth 멤버는 0이어야 합니다. 이 날짜를 지정하면 이 구조체의 DaylightDate 멤버도 지정해야 합니다.
그렇지 않으면 시스템에서 표준 시간대 데이터가 유효하지 않으며 변경 내용이 적용되지 않는다고 가정합니다.
해당 월의 올바른 날짜를 선택하려면 wYear 멤버를 0으로 설정하고, wHour 및 wMinute 멤버를 전환 시간으로 설정하고, wDayOfWeek 멤버를 적절한 평일로 설정하고, wDay 멤버를 사용하여 해당 월 내의 요일 발생을 나타냅니다(1에서 5로, 요일이 5번 발생하지 않는 경우 5는 해당 월의 최종 발생을 나타냅니다).
이 표기법을 사용하여 wHour = 2, wMonth = 4, wDayOfWeek = 0, wDay = 1과 같이 4월 첫 번째 일요일에 02:00을 지정합니다. wHour = 2, wMonth = 10, wDayOfWeek = 4, wDay = 5와 같이 10월 마지막 목요일에 02:00을 지정합니다.
wYear 멤버가 0이 아니면 전환 날짜는 절대입니다. 한 번만 발생합니다. 그렇지 않으면 매년 발생하는 상대 날짜입니다.
StandardBias
표준 시간 동안 발생하는 현지 시간 번역 중에 사용할 바이어스 값입니다. StandardDate 멤버에 대한 값이 제공되지 않으면 이 멤버는 무시됩니다.
이 값은 표준 시간 동안 사용되는 바이어스 형성을 위해 Bias 멤버의 값에 추가됩니다. 대부분의 표준 시간대에서 이 멤버의 값은 0입니다.
DaylightName[32]
일광 절약 시간에 대한 설명입니다. 예를 들어 "PDT"는 태평양 일광 절약 시간을 나타낼 수 있습니다. 문자열은 GetTimeZoneInformation 함수에 의해 변경되지 않고 반환됩니다. 이 문자열은 비어 있을 수 있습니다.
DaylightDate
이 운영 체제에서 표준 시간에서 일광 절약 시간으로의 전환이 발생하는 날짜 및 현지 시간을 포함하는 SYSTEMTIME 구조입니다. 표준 시간대가 일광 절약 시간을 지원하지 않거나 호출자가 일광 절약 시간을 사용하지 않도록 설정해야 하는 경우 SYSTEMTIME 구조의 wMonth 멤버는 0이어야 합니다. 이 날짜를 지정하면 이 구조체의 StandardDate 멤버도 지정해야 합니다.
그렇지 않으면 시스템에서 표준 시간대 데이터가 유효하지 않으며 변경 내용이 적용되지 않는다고 가정합니다.
해당 월의 올바른 날짜를 선택하려면 wYear 멤버를 0으로 설정하고, wHour 및 wMinute 멤버를 전환 시간으로 설정하고, wDayOfWeek 멤버를 적절한 평일로 설정하고, wDay 멤버를 사용하여 해당 월 내의 요일 발생을 나타냅니다(1에서 5로, 요일이 5번 발생하지 않는 경우 5는 해당 월의 최종 발생을 나타냅니다).
wYear 멤버가 0이 아니면 전환 날짜는 절대입니다. 한 번만 발생합니다. 그렇지 않으면 매년 발생하는 상대 날짜입니다.
DaylightBias
일광 절약 시간 동안 발생하는 현지 시간 변환 중에 사용할 바이어스 값입니다. DaylightDate 멤버에 대한 값이 제공되지 않으면 이 멤버는 무시됩니다.
이 값은 바이어스 멤버의 값에 추가되어 일광 절약 시간 동안 사용되는 바이어스 형식입니다. 대부분의 표준 시간대에서 이 멤버의 값은 –60입니다.
설명
각 표준 시간대에 대한 설정은 다음 레지스트리 키에 저장됩니다.
HKEY_LOCAL_MACHINE SOFTWARE Microsoft Windows NT CurrentVersion Time Zones time_zone_name
각 표준 시간대 항목에는 다음 레지스트리 값이 포함됩니다.
| 레지스트리 값 | 유형 | Description |
|---|---|---|
| 표시 | REG_SZ | 표시 이름입니다. |
| Dlt | REG_SZ | 일광 절약 시간에 대한 설명입니다. |
| MUI_Display | REG_SZ | @path,-stringID[; 형식의 문자열로 표시되는 이름입니다.comment]. 자세한 내용은 MUI를 참조하세요. |
| MUI_Dlt | REG_SZ | 일광 절약 시간에 대한 설명은 @path,-stringID[; 형식의 문자열입니다.comment]. |
| MUI_Std | REG_SZ | 표준 시간에 대한 설명은 @path,-stringID[; 형식의 문자열입니다.comment]. |
| 성병 | REG_SZ | 표준 시간대에 대한 설명입니다. |
| Tzi | REG_BINARY |
다음 표준 시간대 정보입니다.
|
동적 DST 키에 대한 자세한 내용은 DYNAMIC_TIME_ZONE_INFORMATION.
StandardName과 DaylightName은 모두 현재 사용자 기본 UI 언어에 따라 지역화됩니다.
예제
예제는 SetTimeZoneInformation을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 머리글 | timezoneapi.h(Windows.h 포함) |