Condividi tramite


Struttura SYSTEMTIME (minwinbase.h)

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:

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)

Vedi anche

FILETIME

FileTimeToSystemTime

GetLocalTime

GetSystemTime

SetLocalTime

SetSystemTime

SystemTimeToFileTime

ULARGE_INTEGER