Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

mktime — konwersja i normalizacja czasu lokalnego

mktime przekształca lokalny czas zapisany w struct tm na time_t, normalizując pola przy powodzeniu.

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

Składnia

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

mktime z <time.h> przyjmuje wskaźnik do modyfikowalnego struct tm. Interpretuje czas jako lokalny, nie UTC; kodowanie time_t nie musi oznaczać sekund uniksowych.

tm_year liczy lata od 1900, a tm_mon miesiące od 0. Pola mogą przekraczać zwykłe zakresy. Przy powodzeniu funkcja normalizuje strukturę i wylicza ignorowane wejściowo tm_wday oraz tm_yday.

tm_isdst: wartość dodatnia oznacza czas letni, zero jego brak, ujemna żąda rozpoznania. Dla godzin pominiętych lub powtórzonych podczas zmiany czasu wybór jest nieokreślony.

Wynikiem jest time_t; niereprezentowalny czas daje (time_t)-1. Normalizacja nie jest ścisłą walidacją daty.

Przykłady

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

Wynik

2024-02-01

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła