KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

mktime — lokale tijd omzetten en normaliseren

mktime zet de lokale tijd in een struct tm om naar time_t en normaliseert de velden als de functie slaagt.

Versie: C23; repository compiler flag, production runtime not attested

Syntax

#include <time.h>
time_t mktime(struct tm *timeptr);

mktime uit <time.h> accepteert een pointer naar een wijzigbare struct tm. De functie interpreteert de tijd als lokale tijd, niet als UTC; time_t hoeft geen Unix-seconden te coderen.

tm_year telt jaren vanaf 1900 en tm_mon maanden vanaf 0. De velden mogen buiten hun gebruikelijke bereiken vallen. Bij succes normaliseert de functie de structuur en berekent ze tm_wday en tm_yday; de aanvankelijke invoerwaarden daarvan worden genegeerd.

tm_isdst: een positieve waarde betekent zomertijd, nul betekent geen zomertijd en een negatieve waarde vraagt om detectie. Voor overgeslagen of herhaalde kloktijden tijdens overgangen is de keuze niet gespecificeerd.

Het resultaat is een time_t; een niet-representeerbare tijd levert (time_t)-1 op. Normalisatie is geen strikte datumvalidatie.

Voorbeelden

#include <stdio.h>
#include <time.h>

int main(void)
{
    struct tm t = {0};
    t.tm_year = 2024 - 1900;
    t.tm_mon = 0;
    t.tm_mday = 32;
    t.tm_hour = 12;
    t.tm_isdst = -1;

    if (mktime(&t) == (time_t)-1) {
        puts("conversion failed");
        return 1;
    }

    printf("%04d-%02d-%02d\n",
           t.tm_year + 1900, t.tm_mon + 1, t.tm_mday);
    return 0;
}

Resultaat

2024-02-01

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen