====== gmtime() ======

gmtime ist definiert in der ''[[start|time]]'', die in C über ''time.h'', bzw. in C++ über ''ctime'' eingebunden wird.


===== Funktion =====
Konvertiert einen Zeitstempel ([[time_t]]) in eine [[struct_tm|tm-Struktur]], entsprechend GMT Zeitzone (Greenwich Mean Time, entspricht der koordinierten Weltzeit, UTC, "Universal Time Coordonné").

===== Signatur =====

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

**timeStamp**: zu übersetzender Zeitstempel ([[time_t]])

**Return value**: Zeiger auf eine statisch alloziierte [[struct_tm|tm-Struktur]].

===== Fehlerquellen =====

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

===== Beispiel =====

<code cpp>
#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;
}
</code>

Ausgabe:
<code>
Aktuelle Uhrzeiten rund um die Welt:
Phoenix, AZ (U.S.) :  23:11
Reykjavik (Iceland) :  6:11
Beijing (China) :     14:11
</code>
===== siehe auch =====

[[c:lib:time:start|time]]: [[c:lib:time:struct_tm|struct tm]], [[c:lib:time:time_t|time_t]], [[c:lib:time:localtime|localtime()]], [[c:lib:time:mktime|mktime()]]