localtime

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu time.h - Index


Header-Datei

time.h

Kategorie

Uhrzeit- und Datumsroutinen

Prototyp

struct tm *localtime(const time_t *timer);

Beschreibung

Konvertiert Datum und Zeit in eine Struktur.

localtime akzeptiert die Adresse eines von time zurückgegebenen Werts und gibt einen Zeiger auf eine Struktur des Typs tm zurück, die Zeitwerte enthält. Die Funktion berücksichtigt die Zeitzone und gegebenenfalls die Sommerzeit.

Die globale Variable _timezone des Typs long enthält die Differenz zwischen GMT und der lokalen Standardzeit in Sekunden (in PST ist _timezone 8*60*60). Die globale Variable _daylight legt fest, ob die Laufzeitfunktionen (mktime und localtime) die Sommerzeit berücksichtigen müssen, wenn sie einen Datumswert bearbeiten, der normalerweise von dieser Einstellung betroffen wird. Hat diese Variable den Wert 1, muss die Sommerzeit berücksichtigt werden. Diese Variablen werden von der Funktion tzset gesetzt, nicht von einer Anwendung.

Die Struktur tm ist in der Header-Datei time.h folgendermaßen deklariert:

struct tm {

int tm_sec;

int tm_min;

int tm_hour;

int tm_mday;

int tm_mon;

int tm_year;

int tm_wday;

int tm_yday;

int tm_isdst;

};

Diese Felder speichern die Zeit auf 24-Stunden-Basis, den Tag des Monats (1 bis 31), den Monat (0 bis 11), den Wochentag (Sonntag entspricht 0), das Jahr - 1900, den Tag des Jahres (0 bis 365) und einen Wert ungleich Null, wenn die Sommerzeit berücksichtigt werden muss.

Rückgabewert

localtime gibt einen Zeiger auf die Struktur mit den Zeitangaben zurück. Diese Struktur ist statisch, wird also bei jedem weiteren Aufruf überschrieben.

Beispiel



 #include <time.h>
 #include <stdio.h>
 int main(void)
 {
    time_t timer;
    struct tm *tblock;
    /* Tageszeit ermitteln */
    timer = time(NULL);
    /* Datum und Zeit in eine Struktur konvertieren */
    tblock = localtime(&timer);
    printf("Local time is: %s", asctime(tblock));
    return 0;
 }



Portabilität



POSIX Win32 ANSI C ANSI C++

+

+

+

+