Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

mktime — převod a normalizace místního času

mktime převádí místní čas uložený ve struct tm na time_t a při úspěchu normalizuje její pole.

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

Syntaxe

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

mktime z <time.h> přijímá ukazatel na upravitelnou struct tm. Čas interpretuje jako místní, nikoli jako UTC; time_t nemusí kódovat sekundy Unixového času.

tm_year počítá roky od roku 1900 a tm_mon měsíce od 0. Hodnoty polí mohou překračovat obvyklé rozsahy. Při úspěchu funkce strukturu normalizuje a vypočítá tm_wday a tm_yday, jejichž vstupní hodnoty se zpočátku ignorují.

tm_isdst: kladná hodnota znamená letní čas, nula jeho nepřítomnost a záporná hodnota žádá o rozpoznání. U přeskočených nebo opakovaných časů při změně času není volba specifikována.

Výsledkem je time_t; čas, který nelze reprezentovat, vrátí (time_t)-1. Normalizace není přísnou kontrolou platnosti data.

Příklady

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

Výsledek

2024-02-01

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje