std::time

std::time_t time( std::time_t* arg );

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

Параметры

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

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

Примечания

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

Пример

#include <ctime>
#include <iostream>
 
int main()
{
    std::time_t result = std::time(nullptr);
    std::cout << std::asctime(std::localtime(&result))
              << result << " seconds since the Epoch\n";
}

Wed Sep 21 10:27:52 2011
1316615272 seconds since the Epoch

См. также