Struttura SYSTEMTIME (minwinbase.h)

Articolo
08/24/2023

Specifica una data e un'ora, usando singoli membri per il mese, il giorno, l'anno, l'anno, l'ora, l'ora, il minuto, il secondo e millisecondo. L'ora è in ora UTC (coordinate universali) o ora locale, a seconda della funzione che viene chiamata.

Sintassi

typedef struct _SYSTEMTIME {
  WORD wYear;
  WORD wMonth;
  WORD wDayOfWeek;
  WORD wDay;
  WORD wHour;
  WORD wMinute;
  WORD wSecond;
  WORD wMilliseconds;
} SYSTEMTIME, *PSYSTEMTIME, *LPSYSTEMTIME;

Members

wYear

Anno. I valori validi per questo membro sono da 1601 a 30827.

wMonth

Il mese. Questo membro può essere uno dei valori seguenti.

Valore	Significato
1	January
2	Febbraio
3	Marzo
4	April
5	Mag
6	Giugno
7	Luglio
8	Agosto
9	Settembre
10	Ottobre
11	Novembre
12	Dicembre

wDayOfWeek

Il giorno della settimana. Questo membro può essere uno dei valori seguenti.

Valore	Significato
0	Sunday
1	Monday
2	Tuesday
3	Wednesday
4	Thursday
5	Friday
6	Sabato

wDay

Il giorno del mese. I valori validi per questo membro sono da 1 a 31.

wHour

L'ora. I valori validi per questo membro sono da 0 a 23.

wMinute

Il minuto I valori validi per questo membro sono da 0 a 59.

wSecond

Il secondo. I valori validi per questo membro sono da 0 a 59.

wMilliseconds

Millisecondo. I valori validi per questo membro sono da 0 a 999.

Commenti

Nota

SystemTIME non verifica se la data rappresentata è una data reale e valida. Quando si lavora con questa API, è consigliabile garantire la validità, soprattutto negli scenari dell'anno bisestile. Per altre informazioni, vedere Preparazione del giorno salti .

Non è consigliabile aggiungere e sottraere valori dalla struttura SYSTEMTIME per ottenere tempi relativi. In alternativa, è necessario:

Convertire la struttura SYSTEMTIME in una struttura FILETIME .
Copiare la struttura FILETIME risultante in una struttura ULARGE_INTEGER .
Usare l'aritmetica a 64 bit normale sul valore ULARGE_INTEGER .

Il sistema può aggiornare periodicamente l'ora sincronizzando con un'origine temporale. Poiché il tempo di sistema può essere modificato in avanti o indietro, non confrontare le letture del tempo di sistema per determinare il tempo trascorso. Usare invece uno dei metodi descritti in Tempo di Windows.

Esempio

Nell'esempio seguente viene illustrata la differenza tra i valori temporali recuperati dalle funzioni GetSystemTime e 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);
}

// Sample output

The system time is: 19:34
 The local time is: 12:34

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Intestazione	minwinbase.h (includere Windows.h)