time

time_t time( time_t *arg );

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

Параметры

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

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

Примечания

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

Пример

#include <stdio.h>
#include <time.h>
#include <stdint.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)

Ссылки

• Стандарт 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

См. также