Структура TIME_ZONE_INFORMATION


Структура TIME_ZONE_INFORMATION определяет информацию, заданную для часового пояса.

Синтаксис

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;

 

Члены структуры

Bias

 Текущее смещение для преобразования местного времени на этом компьютере, в минутах. Смещение - это различие, в минутах, между Универсальным глобальным временем (UTC) и местным временем. Все преобразования между UTC и местным временем основаны на нижеследующей формуле:
 

UTC = local time + bias

Этот член структуры - обязателен.

StandardName

Указатель на строку с завершающим нулем связанную со стандартным временем. Например, "EST" может обозначать Восточное Стандартное Время. Строка должна возвращаться неизменной функцией GetTimeZoneInformation. Эта строка может быть пустой.

StandardDate

Это структура SYSTEMTIME, которая содержит дату и местное время, когда в этой операционной системе происходит переход от летнего времени в стандартное время. Если эта дата не определяется, член wMonth в структуре SYSTEMTIME должен быть нулем. Если эта дата определяется, значение DaylightDate в структуре TIME_ZONE_INFORMATION должно быть также определено.

Не устанавливайте это значение для отдельного года; установите общий день месяца, чтобы использовать его на периодической основе. Чтобы выбрать правильный день в октябре, установим член структуры wYear  в нуль, член структуры wMonth = 10, wDayOfWeek = 0 (воскресенье), а член структуры wDay = 5 (прошлое воскресенье).

StandardBias

Значение смещения, используемое в ходе преобразований местного времени, которые имеют место в ходе перехода на стандартное время. Этот член структуры игнорируется, если не предоставляется значение для члена структуры StandardDate.

Это значение добавляется к значению члена структуры Bias, чтобы сформировать смещение, используемое в ходе перехода на стандартное время. В большинстве часовых поясов значение этого члена структуры - нуль.

DaylightName

Указатель на строку с завершающим нулем, связанную с летним временем. Например, "PDT" может служить признаком Тихоокеанского Летнего времени (Pacific Daylight Time). Строка должна возвращаться неизменной функцией GetTimeZoneInformation. Эта строка может быть пустой.

DaylightDate

Это структура SYSTEMTIME, которая содержит дату и местное время, когда в этой операционной системе происходит переход от летнего времени в стандартное время. Если эта дата не определяется, член wMonth в структуре SYSTEMTIME должен быть нулем. Если эта дата определяется, значение StandardDate в структуре TIME_ZONE_INFORMATION должно быть также определено.

Не устанавливайте это значение для отдельного года; установите общий день месяца, чтобы использовать его на периодической основе. Чтобы выбрать правильный день в апреле, установим член структуры wYear  в нуль, член структуры wMonth = 4, wDayOfWeek = 0 (воскресенье), а член структуры wDay = 1 (первое воскресенье).

DaylightBias

Значение смещения, используемое в ходе преобразований местного времени, которые имеют место в ходе перехода на летнее время. Этот член структуры игнорируется, если не предоставляется значение для члена структуры DaylightDate.

Это значение добавляется к значению члена структуры Bias, чтобы сформировать смещение, используемое в ходе перехода на летнее время. В большинстве часовых поясов значение этого члена структуры  – (минус)60.

Демонстрационный код

Пример смотри в описании функции SetTimeZoneInformation.

Смотри также

Обзор Время (операционной системы), Структуры, используемые для времениGetTimeZoneInformation, SetTimeZoneInformation, SYSTEMTIME

Размещение и совместимость TIME_ZONE_INFORMATION
К Windows Vista Да
л Windows XP Да
и Windows 2000 Professional Да
е Windows NT Workstation Да
н Windows Me Да
т Windows 98 Да
  Windows 95 Да
 
С Windows Server 2008 Да
е Windows Server 2003 Да
р Windows 2000 Server Да
в Windows NT Server Да
е    
р    
Используемая библиотека -
Используемая DLL -
Заголовочный файл  
- объявлено в Winbase.h
- включено в Windows.h
Unicode Нет
Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz