KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

localtime — C23-tijdfunctie

`localtime(timer)` uit `<time.h>` zet de aangeduide `time_t` om in uitgesplitste lokale burgerlijke tijd en retourneert een pointer naar `struct tm`; zij past tijdzone- en zomertijdregels van de omgeving toe. Bij mislukken kan null volgen.

Versie: C23

Syntax

struct tm *localtime(const time_t *timer);

localtime(timer) uit <time.h> zet de aangeduide time_t om in uitgesplitste lokale burgerlijke tijd en retourneert een pointer naar struct tm; zij past tijdzone- en zomertijdregels van de omgeving toe. Bij mislukken kan null volgen.

Het voorbeeld geeft een nul-time_t aan localtime en controleert pointer en bereiken voor maand, dag, uur, minuut en seconde. Het drukt in de omgeving 1 af zonder een bepaalde tijdzone aan te nemen.

Het resultaat wijst naar een statisch object dat een latere localtime, gmtime of ctime kan overschrijven; kopieer struct tm meteen. Gelijktijdige aanroepen hoeven niet veilig te zijn. tm_isdst kan positief, nul of negatief zijn; dubbelzinnige of ontbrekende lokale tijden rond DST vereisen zorg bij terugconversie met mktime.

Voorbeelden

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

Resultaat

1

Het voorbeeld geeft een nul-`time_t` aan `localtime` en controleert pointer en bereiken voor maand, dag, uur, minuut en seconde. Het drukt in de omgeving `1` af zonder een bepaalde tijdzone aan te nemen.

Bronnen