다음을 통해 공유

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 다음 표준 시간대 정보입니다. 
typedef struct _REG_TZI_FORMAT
{
    LONG Bias;
    LONG StandardBias;
    LONG DaylightBias;
    SYSTEMTIME StandardDate;
    SYSTEMTIME DaylightDate;
} REG_TZI_FORMAT;
 

동적 DST 키에 대한 자세한 내용은 DYNAMIC_TIME_ZONE_INFORMATION.

StandardName과 DaylightName은 모두 현재 사용자 기본 UI 언어에 따라 지역화됩니다.

예제

예제는 SetTimeZoneInformation을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱 | UWP 앱]
머리글 timezoneapi.h(Windows.h 포함)

추가 정보

DYNAMIC_TIME_ZONE_INFORMATION

GetTimeZoneInformation

Systemtime

SetTimeZoneInformation