База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

mktime — преобразуване и нормализиране на местно време

mktime преобразува местното време, записано в struct tm, в time_t и при успех нормализира полетата на структурата.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

mktime от <time.h> приема указател към променяема struct tm. Функцията тълкува времето като местно, а не като UTC; time_t не е задължително да кодира секунди от Unix времето.

tm_year брои годините от 1900 г., а tm_mon брои месеците от 0. Стойностите на полетата могат да надхвърлят обичайните им диапазони. При успех функцията нормализира структурата и изчислява tm_wday и tm_yday, чиито първоначални входни стойности се пренебрегват.

tm_isdst: положителна стойност означава лятно часово време, нула означава, че то не е в сила, а отрицателна стойност изисква разпознаване. При пропуснати или повторени часове при смяна на времето изборът не е специфициран.

Резултатът е time_t; време, което не може да бъде представено, дава (time_t)-1. Нормализирането не е строга проверка на валидността на датата.

Примери

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

Резултат

2024-02-01

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници