WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

localtime — C23-Zeitfunktion

`localtime(timer)` aus `<time.h>` wandelt den bezeichneten `time_t` in zerlegte lokale Kalenderzeit um und liefert einen Zeiger auf `struct tm`; dabei gelten Zeitzonen- und Sommerzeitregeln der Umgebung. Bei Fehler kann null folgen.

Version: C23

Syntax

struct tm *localtime(const time_t *timer);

localtime(timer) aus <time.h> wandelt den bezeichneten time_t in zerlegte lokale Kalenderzeit um und liefert einen Zeiger auf struct tm; dabei gelten Zeitzonen- und Sommerzeitregeln der Umgebung. Bei Fehler kann null folgen.

Das Beispiel übergibt einen time_t von null an localtime und prüft Zeiger sowie Bereiche für Monat, Tag, Stunde, Minute und Sekunde. Es gibt in der Laufzeitumgebung 1 aus, ohne eine Zeitzone anzunehmen.

Das Ergebnis zeigt auf ein statisches Objekt, das ein späteres localtime, gmtime oder ctime überschreiben kann; struct tm sofort kopieren. Parallele Aufrufe müssen nicht sicher sein. tm_isdst kann positiv, null oder negativ sein; mehrdeutige oder fehlende Ortszeiten am DST-Wechsel erfordern beim Rückweg über mktime Vorsicht.

Beispiele

#include <stdio.h>
#include <time.h>
int main(void){time_t raw=0;struct tm *v=localtime(&raw);int ok=v&&v->tm_mon>=0&&v->tm_mon<=11&&v->tm_mday>=1&&v->tm_mday<=31&&v->tm_hour>=0&&v->tm_hour<=23&&v->tm_min>=0&&v->tm_min<=59&&v->tm_sec>=0&&v->tm_sec<=60;printf("%d\n",ok);return 0;}

Ergebnis

1

Das Beispiel übergibt einen `time_t` von null an `localtime` und prüft Zeiger sowie Bereiche für Monat, Tag, Stunde, Minute und Sekunde. Es gibt in der Laufzeitumgebung `1` aus, ohne eine Zeitzone anzunehmen.

Quellen