Структура SYSTEMTIME

Структура SYSTEMTIME представляет дату и время, используя отдельные члены для месяца, дня, года, дня недели, часа, минут, секунд и миллисекунд.

Синтаксис

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

Год. Допустимые значения для этого члена структуры 1601 - 30827.

Месяц. Этот член структуры может быть одним из ниже перечисленных значений.

wDayOfWeek

День недели. Этот член структуры может быть одним из ниже перечисленных значений.

Значение	Предназначение
0	Sunday (Воскресенье)
1	Monday (Понедельник)
2	Tuesday (Вторник)
3	Wednesday (Среда)
4	Thursday (Четверг)
5	Friday (Пятница)
6	Saturday (Суббота)

wDay

wHour

wMinute

wSecond

wMilliseconds

Замечания

Не рекомендуется, что бы Вы добавляли и вычитали значения из структуры SYSTEMTIME, чтобы получить относительное время. Вместо этого Вы должны:

• Преобразовать структуру SYSTEMTIME в структуру FILETIME.
• Скопируйте получившуюся структуру FILETIME в структуру ULARGE_INTEGER.
• Используйте обычную 64-битовую арифметику для значений ULARGE_INTEGER.(Подробно операция изложена в описании функции).

Система может периодически обновлять время, синхронизируя с источником времени. Поскольку системное время, может регулироваться или вперед, или назад, не сравнивайте данные системного времени, чтобы определить истекшее время. Вместо этого используйте один из методов, рассмотренных в статье Время операционной системы Windows.

Демонстрационный код [C++]

Пример ниже демонстрирует различие между значениями времени, найденными функциями GetSystemTime и GetLocalTime.

#include <windows.h>
#include <stdio.h>

void main()
{
    SYSTEMTIME st, lt;
    
    GetSystemTime(&st);
    GetLocalTime(&lt);
    
    printf("The system time is: %02d:%02d\n", st.wHour, st.wMinute);
    printf(" The local time is: %02d:%02d\n", lt.wHour, lt.wMinute);
}

Смотри также

Обзор Время (операционной системы), Структуры, используемые для времени, FILETIME, FileTimeToSystemTime, GetSystemTime, ULARGE_INTEGER, SetSystemTime