gmtime, _gmtime32, _gmtime64

Artikel
02/26/2013

Konvertiert einen Zeitwert Struktur.Sicherere Versionen dieser Funktionen sind verfügbar. Weitere Informationen finden Sie unter gmtime_s, _gmtime32_s, _gmtime64_s.

struct tm *gmtime( 
   const time_t *timer 
);
struct tm *_gmtime32( 
   const time32_t *timer 
);
struct tm *_gmtime64( 
   const __time64_t *timer 
);

Parameter

timer
Zeiger auf gespeicherten Zeit.Die Zeit wird als verstrich seit Mitternacht vergangenen Sekunden (00:00) dargestellt: am 1. Januar 1970 00) koordinierte Weltzeit (UTC).

Rückgabewert

Geben Sie einen Zeiger auf eine Struktur vom Typ TMzurück.Die Felder der zurückgegebenen Struktur halten den ausgewerteten Wert des Arguments timer anstelle von UTC in Ortszeit angegeben.Alle Felder der Struktur ist vom Typ intwie folgt:

tm_sec
Sekunden (0 Minute nach 59).
tm_min
Minuten nach der vollen Stunde (0:59).
tm_hour
seit Mitternacht vergangenen Stunden (0:23).
tm_mday
Tag des Monats (1 bis 31).
tm_mon
Monat (0 bis 11. Januar = 0).
tm_year
Jahres (laufendes Jahr minus 1900).
tm_wday
Tag der Woche (0 – 6; Sonntag = 0).
tm_yday
Tag des Jahres (0 – 365; Am 1. Januar = 0).
tm_isdst
Immer 0 für gmtime.

verwenden die 32-Bit- und 64-Bit-Versionen von gmtime, mktime, mkgmtimeund alle localtimeeine einzelne Struktur tm pro Thread für die Konvertierung.Jeder Aufruf, bis eine dieser Funktionen zerstört das Ergebnis eines früheren Aufrufs.Wenn timer ein Datum vor Mitternacht am 1. Januar 1970 darstellt gmtime gibt NULLzurück.Es gibt keine Fehler werden.

_gmtime64, die die __time64_t - Struktur verwendet, stellt die oben und 23:59 Datumsangaben ausgedrückt werden: 59 3000 am 31. Dezember, UTC, während _gmtime32 nur Datumsangaben nach 03:14 Uhr darstellen: Am 7. Januar 19 2038, UTC.Mitternacht am 1. Januar 1970 ist die Untergrenze des Datumsbereichs für beide dieser Funktionen.

gmtime ist eine Inlinefunktion, die _gmtime64 auswertet und time_t zu __time64_tentspricht.Wenn Sie den Compiler erzwingen müssen, um alte als time_t 32-Bit- time_tinterpretiert wird, können Sie _USE_32BIT_TIME_Tdefinieren.Auf diese Weise wird gmtime , _gmtime32in-gesäumt sein.Dies wird nicht empfohlen, da die Anwendung möglicherweise nach dem 18. Januar 2038 fehlschlägt, und sie wird nicht auf 64-Bit-Plattformen nicht zulässig.

Diese Funktionen überprüfen ihren Parametern.Wenn timer ein NULL-Zeiger ist, oder wenn der Zeitgeber dem Wert negativ ist, rufen diese Funktionen einen ungültigen Parameter für ein, wie in Parametervalidierungbeschrieben.Wenn die Ausführung fortgesetzt werden kann, darf die Funktionen geben NULL festlegen und errno zu EINVAL.

Hinweise

Die _gmtime32-Funktion beschreibt den Wert timer auf und speichert ihn in einer statisch zugeordnete Struktur des Typs tm, definiert in TIME.H.Der Wert von timer wird normalerweise von einem Aufruf der time-Funktion abgerufen.

Hinweis
Die Zielumgebung versuchen soll, um zu ermitteln, ob der Sommerzeit gültig ist.Die C-Laufzeitbibliothek weist folgendes USA-Regeln zum Implementieren der Berechnung der Sommerzeit an (DST).

Anforderungen

Routine	Erforderlicher Header
gmtime	<time.h>
_gmtime32	<time.h>
_gmtime64	<time.h>

Um Kompatibilität zusätzlichen Informationen finden Sie unter Kompatibilität in der Einführung.

Beispiel

// crt_gmtime.c
// compile with: /W3
// This program uses _gmtime64 to convert a long-
// integer representation of coordinated universal time
// to a structure named newtime, then uses asctime to
// convert this structure to an output string.
 
#include <time.h>
#include <stdio.h>

int main( void )
{
   struct tm *newtime;
   __int64 ltime;
   char buff[80];

   _time64( &ltime );

   // Obtain coordinated universal time:
   newtime = _gmtime64( &ltime ); // C4996
   // Note: _gmtime64 is deprecated; consider using _gmtime64_s
   asctime_s( buff, sizeof(buff), newtime );
   printf( "Coordinated universal time is %s\n", buff );
}