Namespaces
Variants

std:: time

From cppreference.net
< cpp ‎ | chrono ‎ | c
Определено в заголовочном файле <ctime>

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

Содержание

Параметры

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

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

Текущее календарное время, закодированное как объект 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

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

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