mktime

time_t mktime( struct tm *arg );

Перенормирует локальное календарное время, выраженное как объект struct tm, и также преобразует его во временную метку, как объект time_t. arg->tm_wday и arg->tm_yday игнорируются. Значения в arg не проверяются на выход за пределы допустимого диапазона.

Отрицательное значение arg->tm_isdst заставляет mktime попытаться определить, было ли летнее время (DST) в указанное время.

Если преобразование в time_t выполняется успешно, объект arg изменяется. Все поля объекта arg обновляются, чтобы соответствовать допустимым значениям. arg->tm_wday и arg->tm_yday пересчитываются с использованием информации, доступной в других полях.

Параметры

Возвращаемое значение

временная метка, как объект time_t, в случае успеха, или -1, если arg нельзя представить как объект time_t (POSIX также требует, чтобы EOVERFLOW было сохранено в errno в этом случае).

Примечания

Если объект struct tm был получен из POSIX strptime или эквивалентной функции, значение tm_isdst неопределено и должно быть установлено явно перед вызовом mktime.

Пример

#define _POSIX_C_SOURCE 200112L // for setenv on gcc
#include <stdlib.h>
#include <stdio.h>
#include <time.h>
 
int main(void)
{
    setenv("TZ", "/usr/share/zoneinfo/America/New_York", 1); // POSIX-specific
 
    struct tm tm = *localtime(&(time_t){time(NULL)});
    printf("Today is           %s", asctime(&tm));
    printf("(DST is %s)\n", tm.tm_isdst ? "in effect" : "not in effect");
    tm.tm_mon -= 100;  // tm_mon is now outside its normal range
    mktime(&tm);       // tm_isdst is not set to -1; today's DST status is used
    printf("100 months ago was %s", asctime(&tm));
    printf("(DST was %s)\n", tm.tm_isdst ? "in effect" : "not in effect");
}

Today is           Fri Apr 22 11:53:36 2016
(DST is in effect)
100 months ago was Sat Dec 22 10:53:36 2007
(DST was not in effect)

Ссылки

• Стандарт C17 (ISO/IEC 9899:2018):
• 7.27.2.3 Функция mktime (с. 285-286)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.27.2.3 Функция mktime (с. 390-391)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.23.2.3 Функция mktime (с. 340-341)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.12.2.3 Функция mktime

См. также