time

time_t time( time_t* arg );

Возвращает текущее календарное время, закодированное в виде объекта time_t, а также сохраняет его в объекте time_t, на который указывает arg (если только arg не является нулевым указателем)

Параметры

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

Текущее календарное время, закодированное в виде объекта time_t, в случае успеха; (time_t)(-1) в случае ошибки. Если arg не является нулевым указателем, возвращаемое значение также сохраняется в объекте, на который указывает arg.

Примечания

Способ кодирования календарного времени в time_t не определён, однако большинство систем соответствуют спецификации POSIX и возвращают значение целочисленного типа, содержащее количество секунд, прошедших с начала эпохи. Реализации, в которых time_t является 32-разрядным целым числом со знаком (многие исторические реализации), перестают работать в 2038 году.

Пример

#include <stdint.h>
#include <stdio.h>
#include <time.h>

int main(void)
{
    time_t result = time(NULL);
    if (result != (time_t)(-1))
        printf("The current time is %s(%jd seconds since the Epoch)\n",
               asctime(gmtime(&result)), (intmax_t)result);
}

The current time is Fri Apr 24 15:05:25 2015
(1429887925 seconds since the Epoch)

Ссылки

• Стандарт C23 (ISO/IEC 9899:2024):
• 7.27.2.4 Функция time (стр.: уточняется)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.27.2.4 Функция time (стр.: 286)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.27.2.4 Функция time (стр.: 391)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.23.2.4 Функция time (стр.: 341)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.12.2.4 Функция time

См. также