std:: time
|
Определено в заголовочном файле
<ctime>
|
||
|
std::
time_t
time
(
std::
time_t
*
arg
)
;
|
||
Возвращает текущее календарное время, закодированное как объект 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
Смотрите также
|
(C++17)
|
возвращает календарное время в секундах и наносекундах на основе заданной временной базы
(функция) |
|
преобразует время с начала эпохи в календарное время, выраженное как локальное время
(функция) |
|
|
преобразует время с начала эпохи в календарное время, выраженное как всемирное координированное время
(функция) |
|
|
(C++11)
|
время системных часов от общесистемных часов реального времени
(класс) |
|
Документация C
для
time
|
|