gmtime()

gmtime ist definiert in der time, die in C über time.h, bzw. in C++ über ctime eingebunden wird.

Funktion

Konvertiert einen Zeitstempel (time_t) in eine tm-Struktur, entsprechend GMT Zeitzone (Greenwich Mean Time, entspricht der koordinierten Weltzeit, UTC, „Universal Time Coordonné“).

Signatur

#include <time.h>
struct tm * gmtime( time_t timeStamp );

timeStamp: zu übersetzender Zeitstempel (time_t)

Return value: Zeiger auf eine statisch alloziierte tm-Struktur.

Fehlerquellen

Die tm-Struktur wird statisch alloziiert und von gmtime() und localtime() gleichermaßen verwendet. Sobald eine der Funktionen aufgerufen wird, wird die Struktur überschrieben. Im Zweifelsfall sollte der Inhalt kopiert werden.

Beispiel

#include <stdio.h>
#include <time.h>
#include <stdlib.h>
 
#define MST (-7)
#define UTC (0)
#define CCT (+8)
 
int main ()
{
  time_t      timeStamp;
  struct tm * ptm;
 
  time( &timeStamp );
 
  ptm = gmtime( &timeStamp );
 
  puts( "Aktuelle Uhrzeiten rund um die Welt:" );
  printf( "Phoenix, AZ (U.S.) :  %2d:%02d\n", (ptm->tm_hour+MST+24)%24, ptm->tm_min );
  printf( "Reykjavik (Iceland) : %2d:%02d\n", (ptm->tm_hour+UTC+24)%24, ptm->tm_min );
  printf( "Beijing (China) :     %2d:%02d\n", (ptm->tm_hour+CCT+24)%24, ptm->tm_min );
 
  return EXIT_SUCCESS;
}

Ausgabe:

Aktuelle Uhrzeiten rund um die Welt:
Phoenix, AZ (U.S.) :  23:11
Reykjavik (Iceland) :  6:11
Beijing (China) :     14:11

siehe auch