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

См. также