CKTIS / C
mktime — lokale Zeit umwandeln und normalisieren
mktime wandelt die in einer struct tm gespeicherte lokale Zeit in time_t um und normalisiert bei Erfolg die Felder.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <time.h>
time_t mktime(struct tm *timeptr);mktime aus <time.h> erwartet einen Zeiger auf eine beschreibbare struct tm. Die Funktion interpretiert die Zeit als lokale Zeit, nicht als UTC; time_t muss keine Unix-Sekunden codieren.
tm_year zählt die Jahre seit 1900, tm_mon die Monate ab 0. Die Felder dürfen außerhalb ihrer üblichen Wertebereiche liegen. Bei Erfolg normalisiert die Funktion die Struktur und berechnet tm_wday und tm_yday, deren Eingabewerte zunächst ignoriert werden.
tm_isdst: Ein positiver Wert bedeutet Sommerzeit, null bedeutet keine Sommerzeit, ein negativer Wert fordert die Erkennung an. Bei während der Zeitumstellung übersprungenen oder wiederholten Uhrzeiten ist die Auswahl nicht spezifiziert.
Das Ergebnis ist ein time_t; eine nicht darstellbare Zeit ergibt (time_t)-1. Die Normalisierung ist keine strenge Datumsvalidierung.
Beispiele
#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;
}Ergebnis
2024-02-01
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.