Die Funktionen localtime() und localtime64() interpretieren die Zeitangabe, auf die clock zeigt, als Anzahl der Sekunden, die seit dem 1.1.1970 00:00:00 Uhr UTC (Epoche) vergangen sind. Ein solcher Wert wird z.B. von den Funktionen time() und time64() geliefert. localtime() und localtime64() berechnen daraus Datum und Uhrzeit lokaler Zeit und speichern es in einer Struktur vom Typ tm. Negative Werte werden als Sekunden vor der Epoche interpretiert. Dabei werden folgende Zeitpunkte als ungültig betrachtet:
Die lokale Zeitzoneninformationen werden so gesetzt als wenn die Funktion tzset() aufgerufen würde.
localtime() berücksichtigt Zeitzonen und eventuelle Sommerzeit-Korrekturen.
In der Include-Datei time.h sind die Vereinbarungen aller Funktionen und externer Werte sowie der tm-Struktur enthalten. Die Strukturvereinbarung ist wie folgt:
struct tm {
int tm_sec; /* Sekunden - [0, 61] für übersprungene Sek.*/
int tm_min; /* Minuten - [0, 59] */
int tm_hour; /* Stunden - [0, 23] */
int tm_mday; /* Tag des Monats - [1, 31] */
int tm_mon; /* Monate - [0, 11] */
int tm_year; /* Jahre seit 1900 */
int tm_wday; /* Tage seit Sonntag - [0, 6] */
int tm_yday; /* Tage seit dem 1. Januar - [0, 365] */
int tm_isdst; /* Option für Sommerzeit */
};
tm_isdst ist positiv, wenn Sommerzeit eingestellt ist, null, wenn Sommerzeit nicht eingestellt ist, und negativ, wenn die Information nicht verfügbar ist.
localtime() ist nicht threadsicher. Verwenden Sie bei Bedarf die reentrante Funktion localtime_r().
BS2000
localtime() interpretiert die Zeitangabe vom Typ time_t als Anzahl der Sekunden, die seit dem 1. Januar 1970 00:00:00 lokaler Zeit vergangen sind. localtime() berechnet daraus Datum und Uhrzeit und speichert das Ergebnis in einer Struktur vom Typ tm.
localtime() entspricht in dieser Implementierung gmtime(), beide liefern die lokale Zeit. (Ende)
