SYSTEMTIME-Struktur (minwinbase.h)

Artikel
03/04/2024

Gibt ein Datum und eine Uhrzeit an, wobei einzelne Member für Monat, Tag, Jahr, Wochentag, Stunde, Minute, Sekunde und Millisekunde verwendet werden. Die Uhrzeit erfolgt je nach aufgerufener Funktion entweder in koordinierter Weltzeit (UTC) oder Lokalzeit.

Syntax

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

Member

wYear

Das Jahr. Die gültigen Werte für dieses Element sind 1601 bis 30827.

wMonth

Der Monat. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
1	January
2	Februar
3	März
4	April
5	May
6	June
7	Juli
8	August
9	September
10	Oktober
11	November
12	Dezember

wDayOfWeek

Der Tag der Woche. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
0	Sonntag
1	Montag
2	Tuesday
3	Wednesday
4	Thursday
5	Freitag
6	Samstag

wDay

Der Tag des Monats. Die gültigen Werte für diesen Member sind 1 bis 31.

wHour

Die Stunde. Die gültigen Werte für diesen Member sind 0 bis 23.

wMinute

Die Minute. Die gültigen Werte für diesen Member sind 0 bis 59.

wSecond

Die Sekunde. Die gültigen Werte für diesen Member sind 0 bis 59.

wMilliseconds

Die Millisekunde. Die gültigen Werte für diesen Member sind 0 bis 999.

Hinweise

Hinweis

SystemTIME überprüft nicht, ob das dargestellte Datum ein echtes und gültiges Datum ist. Wenn Sie mit dieser API arbeiten, sollten Sie die Gültigkeit sicherstellen, insbesondere in Schaltjahrszenarien. Weitere Informationen finden Sie unter Bereitschaft zum Schalttag .

Es wird nicht empfohlen, Werte aus der SYSTEMTIME-Struktur hinzuzufügen und zu subtrahieren, um relative Zeiten zu erhalten. Stattdessen sollten Sie

Konvertieren Sie die SYSTEMTIME-Struktur in eine FILETIME-Struktur .
Kopieren Sie die resultierende FILETIME-Struktur in eine ULARGE_INTEGER-Struktur .
Verwenden Sie die normale 64-Bit-Arithmetik für den wert der ULARGE_INTEGER .

Das System kann die Zeit regelmäßig aktualisieren, indem es mit einer Zeitquelle synchronisiert wird. Da die Systemzeit entweder vorwärts oder rückwärts angepasst werden kann, sollten Sie die Systemzeitwerte nicht vergleichen, um die verstrichene Zeit zu bestimmen. Verwenden Sie stattdessen eine der unter Windows-Zeit beschriebenen Methoden.

Beispiele

Im folgenden Beispiel wird der Unterschied zwischen den Zeitwerten veranschaulicht, die von den Funktionen GetSystemTime und GetLocalTime abgerufen werden.

#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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Kopfzeile	minwinbase.h (windows.h einschließen)