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.