====== localtime() ======

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

===== Funktion =====
Übersetzt einen Zeitstempel ([[time_t]]) in eine [[struct_tm|tm-Struktur]] in die lokale Zeitzone.

===== Signatur =====

<code cpp>
#include <time.h>

struct tm * localtime( const 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|gmtime()]] und 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>

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;

  time ( &rawtime );
  timeinfo = localtime ( &rawtime );
  printf ( "Das aktuelle Datum lautet: %s", asctime (timeinfo) );

  return EXIT_SUCCESS;
}
</code>

Ausgabe:
<code>Das aktuelle Datum lautet: Thu Mar 26 06:00:48 2009</code>

===== siehe auch =====

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