Partager via


STRUCTURE SYSTEMTIME (minwinbase.h)

Spécifie une date et une heure, à l’aide de membres individuels pour le mois, le jour, l’année, le jour de la semaine, l’heure, la minute, la seconde et la milliseconde. L’heure est en temps universel coordonné (UTC) ou en heure locale, en fonction de la fonction appelée.

Syntaxe

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

Membres

wYear

Année. Les valeurs valides pour ce membre sont 1601 à 30827.

wMonth

Mois. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
1
Janvier
2
February
3
Mars
4
avril
5
Mai
6
June
7
Juillet
8
Août
9
Septembre
10
Octobre
11
Novembre
12
Décembre

wDayOfWeek

Jour de la semaine. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
0
Dimanche
1
Lundi
2
Mardi
3
Mercredi
4
Jeudi
5
Vendredi
6
Samedi

wDay

Jour du mois. Les valeurs valides pour ce membre sont comprises entre 1 et 31.

wHour

Heure. Les valeurs valides pour ce membre sont de 0 à 23.

wMinute

Minute. Les valeurs valides pour ce membre sont comprises entre 0 et 59.

wSecond

Seconde. Les valeurs valides pour ce membre sont comprises entre 0 et 59.

wMilliseconds

Milliseconde. Les valeurs valides pour ce membre sont comprises entre 0 et 999.

Remarques

Notes

SYSTEMTIME ne case activée pas pour voir si la date représentée est une date réelle et valide. Lorsque vous utilisez cette API, vous devez vous assurer de sa validité, en particulier dans les scénarios d’années bissextiles. Pour plus d’informations, consultez Préparation aux jours bissextiles .

Il n’est pas recommandé d’ajouter et de soustraire des valeurs de la structure SYSTEMTIME pour obtenir des temps relatifs. Au lieu de cela, vous devez

Le système peut actualiser régulièrement l’heure en synchronisant avec une source de temps. Étant donné que l’heure système peut être ajustée vers l’avant ou vers l’arrière, ne comparez pas les lectures de temps système pour déterminer le temps écoulé. Utilisez plutôt l’une des méthodes décrites dans Heure Windows.

Exemples

L’exemple suivant illustre la différence entre les valeurs de temps récupérées par les fonctions GetSystemTime et 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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
En-tête minwinbase.h (inclure Windows.h)

Voir aussi

FILETIME

FileTimeToSystemTime

GetLocalTime

GetSystemTime

SetLocalTime

SetSystemTime

SystemTimeToFileTime

ULARGE_INTEGER