Функция time: возвращает текущее календарное время в секундах

Прототип функции time:

time_t time( time_t * timeptr );

Заголовочный файл

Описание

Функция возвращает текущее календарное значение времени в секундах. Если аргумент не является нулевым указателем, ей передается значение времени типа time_t.

Параметры:

• timeptr
  Указатель на объект типа time_t, где хранится значение времени. Также этот параметр может быть нулевым указателем, в этом случае параметр не используется, но объект time_t  по-прежнему возвращается функцией.

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

Текущее календарное время типа time_t. Если аргумент не является нулевым указателем, возвращаемое значение такое же, как то, на которое указывает аргумент. Если функции не удалось получить календарное время, она возвращает значение -1.

Пример: исходный код программы

//пример использования функции time
#include <iostream>
#include <ctime>

int main ()
{
  time_t seconds;

  seconds = time (NULL); // получить текущую дату, выраженную в секундах
  std::cout << "Количество часов, прошедших с 1 января 1970 года = "
            << seconds/3600 << std::endl;

  return 0;
}

Пример работы программы