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.
typedef struct _SYSTEMTIME {
WORD wYear;
WORD wMonth;
WORD wDayOfWeek;
WORD wDay;
WORD wHour;
WORD wMinute;
WORD wSecond;
WORD wMilliseconds;
} SYSTEMTIME, *PSYSTEMTIME, *LPSYSTEMTIME;
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 |
---|---|
|
Janvier |
|
February |
|
Mars |
|
avril |
|
Mai |
|
June |
|
Juillet |
|
Août |
|
Septembre |
|
Octobre |
|
Novembre |
|
Décembre |
wDayOfWeek
Jour de la semaine. Ce membre peut être l’une des valeurs suivantes.
Valeur | Signification |
---|---|
|
Dimanche |
|
Lundi |
|
Mardi |
|
Mercredi |
|
Jeudi |
|
Vendredi |
|
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.
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 .
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(<);
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
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) |