time
Материал из cppreference.com
<tbody>
</tbody>
| Определено в заголовочном файле <time.h>
|
||
time_t time( time_t *arg ); |
||
Возвращает текущее календарное время в формате объекта типа time_t, а также сохраняет его в объекте типа time_t, на который указывает arg (если arg не нулевой указатель).
Параметры
| arg | — | указатель на объект типа time_t, где будет сохранено время, или нулевой указатель |
Возвращаемое значение
Текущее календарное время в формате объекта типа time_t при успехе, (time_t)(-1) при ошибке. Если arg не нулевой указатель, возвращаемое значение также сохраняется в объекте, на который указывает arg.
Замечания
Кодирование календарного времени в типе time_t не определено, однако большинство систем соответствуют спецификации POSIX и возвращают целое значение, равное количеству секунд с начала эпохи Unix. Реализации, в которых time_t это 32-битное знаковое целое (много исторически известных реализаций), дадут неправильный результат в 2038 году.
Пример
Запустить этот код
#include <stdio.h>
#include <time.h>
#include <stdint.h>
int main(void)
{
time_t result = time(NULL);
if(result != (time_t)(-1))
printf("The current time is %s(%jd seconds since the Epoch)\n",
asctime(gmtime(&result)), (intmax_t)result);
}
Возможный вывод:
The current time is Fri Apr 24 15:05:25 2015
(1429887925 seconds since the Epoch)
Ссылки
- Стандарт C17 (ISO/IEC 9899:2018):
- 7.27.2.4 Функция time (стр. 286)
- Стандарт C11 (ISO/IEC 9899:2011):
- 7.27.2.4 Функция time (стр. 391)
- Стандарт C99 (ISO/IEC 9899:1999):
- 7.23.2.4 Функция time (стр. 341)
- Стандарт C89/C90 (ISO/IEC 9899:1990):
- 4.12.2.4 Функция time
См. также
(C23)(C11) |
преобразует время от начала эпохи Unix в календарное время, выраженное как местное время (функция) |
(C23)(C11) |
преобразует время от начала эпохи Unix в календарное время, выраженное в формате Всемирного координированного времени (UTC) (функция) |
(C11) |
возвращает календарное время в секундах и наносекундах по заданному основанию времени (функция) |
Документация C++ по time
| |
