STRUCTURE SYSTEMTIME (minwinbase.h)

Article
03/04/2024

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

Convertissez la structure SYSTEMTIME en structure FILETIME .
Copiez la structure FILETIME obtenue dans une structure ULARGE_INTEGER .
Utilisez l’arithmétique 64 bits normale sur la valeur ULARGE_INTEGER .

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)