Namespaces
Variants

time

From cppreference.net
Определено в заголовочном файле <time.h>
time_t time ( time_t * arg ) ;

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

Содержание

Параметры

arg - указатель на объект time_t , в который будет сохранено время, или нулевой указатель

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

Текущее календарное время, закодированное как объект 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 (стр.: TBD)
  • Стандарт 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

Смотрите также

преобразует время с начала эпохи в календарное время, выраженное как местное время
(функция)
преобразует время с начала эпохи в календарное время, выраженное как всемирное координированное время (UTC)
(функция)
возвращает календарное время в секундах и наносекундах на основе заданной временной базы
(функция)