WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

gmtime — C23-Zeitfunktion

`gmtime(timer)` aus `<time.h>` wandelt den bezeichneten `time_t`-Kalenderzeitwert in zerlegte UTC in einem `struct tm` um. Es liefert einen Zeiger auf das Ergebnis oder null, wenn UTC nicht verfügbar oder der Wert nicht darstellbar ist.

Version: C23

Syntax

struct tm *gmtime(const time_t *timer);

gmtime(timer) aus <time.h> wandelt den bezeichneten time_t-Kalenderzeitwert in zerlegte UTC in einem struct tm um. Es liefert einen Zeiger auf das Ergebnis oder null, wenn UTC nicht verfügbar oder der Wert nicht darstellbar ist.

Das Beispiel übergibt time_t null und druckt in der Unix-Epochenumgebung 1970-01-01 4 0: Datum, Donnerstag als tm_wday == 4 und ersten Jahrestag als tm_yday == 0. C definiert die numerische Bedeutung von null time_t nicht; dieses Datum gehört zur Beispielplattform.

Das Ergebnis kann ein gemeinsames statisches Objekt bezeichnen, das spätere gmtime- oder localtime-Aufrufe überschreiben. Benötigte Felder vorher kopieren und Threads synchronisieren; C23 bietet auch gmtime_r. tm_mon und tm_yday beginnen bei null, tm_year bei 1900 und tm_isdst ist für UTC null. Vor Dereferenzierung immer auf null prüfen.

Beispiele

#include <stdio.h>
#include <time.h>
int main(void){time_t value=(time_t)0;struct tm *utc=gmtime(&value);if(!utc)return 1;printf("%04d-%02d-%02d %d %d\n",utc->tm_year+1900,utc->tm_mon+1,utc->tm_mday,utc->tm_wday,utc->tm_yday);return 0;}

Ergebnis

1970-01-01 4 0

Das Beispiel übergibt `time_t` null und druckt in der Unix-Epochenumgebung `1970-01-01 4 0`: Datum, Donnerstag als `tm_wday == 4` und ersten Jahrestag als `tm_yday == 0`. C definiert die numerische Bedeutung von null `time_t` nicht; dieses Datum gehört zur Beispielplattform.

Quellen