KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

gmtime — C23-tijdfunctie

`gmtime(timer)` uit `<time.h>` zet de aangewezen `time_t`-kalendertijd om in opgesplitste UTC in een `struct tm`-object. Het retourneert een pointer naar het resultaat, of null wanneer UTC niet beschikbaar of de waarde niet weer te geven is.

Versie: C23

Syntax

struct tm *gmtime(const time_t *timer);

gmtime(timer) uit <time.h> zet de aangewezen time_t-kalendertijd om in opgesplitste UTC in een struct tm-object. Het retourneert een pointer naar het resultaat, of null wanneer UTC niet beschikbaar of de waarde niet weer te geven is.

Het voorbeeld geeft time_t nul en print in de Unix-epocheomgeving 1970-01-01 4 0: datum, donderdag als tm_wday == 4 en eerste jaardag als tm_yday == 0. C definieert de numerieke betekenis van nul time_t niet; deze datum is dus van het voorbeeldplatform.

Het resultaat kan een gedeeld statisch object aanwijzen dat latere gmtime- of localtime-aanroepen overschrijven. Kopieer velden en synchroniseer threads; C23 biedt ook gmtime_r. tm_mon en tm_yday beginnen bij nul, tm_year bij 1900 en tm_isdst is nul voor UTC. Test altijd op null vóór derefereren.

Voorbeelden

#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;}

Resultaat

1970-01-01 4 0

Het voorbeeld geeft `time_t` nul en print in de Unix-epocheomgeving `1970-01-01 4 0`: datum, donderdag als `tm_wday == 4` en eerste jaardag als `tm_yday == 0`. C definieert de numerieke betekenis van nul `time_t` niet; deze datum is dus van het voorbeeldplatform.

Bronnen