time.h

Стандартная библиотека языка программирования С

assert.h complex.h ctype.h errno.h fenv.h float.h inttypes.h iso646.h limits.h locale.h math.h setjmp.h signal.h stdarg.h stdbool.h stddef.h stdint.h stdio.h stdlib.h string.h tgmath.h time.h wchar.h wctype.h

time.h — заголовочный файл стандартной библиотеки языка программирования СИ, содержащий типы и функции для работы с датой и временем.

Вступление

Некоторые функции могут работать с местным временем, которое может отличаться от календарного, например в связи с часовыми поясами. Определены арифметические типы clock_t и time_t для представления времени, а структура struct tm содержит компоненты календарного времени.

Имя	Описание
int tm_sec;	Секунды от начала минуты - [0,60][1]
int tm_min;	Минуты от начала часа - [0,59]
int tm_hour;	Часы от полуночи - [0,23]
int tm_mday;	Число месяца - [1,31]
int tm_mon;	Месяцы после января - [0,11]
int tm_year;	Года с 1900 (в Windows), с 1970 (в Unix)
int tm_wday;	Дни с воскресенья - [0,6]
int tm_yday;	Дни с первого января - [0,365]
int tm_isdst;	Признак летнего времени

Поле tm_isdst имеет положительное значение, если активен режим летнего времени, нуль в противном случае и отрицательное значение, если информация о сезоне времени недоступна/неизвестна.

Основные функции

clock_t clock(void)

Возвращает время, измеряемое процессором в тактах от начала выполнения программы, или −1, если оно не известно. Пересчет этого времени в секунды выполняется по формуле clock () / CLOCKS_PER_SEC.

time_t time(time_t *tp)

Возвращает текущее календарное время или −1, если это время не известно. Если указатель tp не равен NULL, то возвращаемое значение записывается также и в *tp.

double difftime(time_t time2,time_t time1)

Возвращает разность time2-time1, выраженную в секундах.

time_t mktime(struct tm *tp)

Преобразует местное время, заданное структурой *tp, в календарное и возвращает его в том же виде, что и функция time(). Компоненты структуры будут иметь значения в указанных выше диапазонах. Функция возвращает календарное время или −1, если оно не представимо.

char *asctime(const struct tm *tp)

Преобразует время из структуры *tp в строку вида "Sun Jan 3 15:14:13 1988\n\0"

Константы

CLOCKS_PER_SEC

Определяет количество тактов системных часов в секунду. Используется для пересчета величины, возвращаемой функцией clock(), в секунды.

CLK_PER_SEC

Альтернативное имя константы CLOCKS_PER_SEC, используемое в некоторых библиотеках.

CLK_TCK

Вышедший из употребления макрос для константы CLOCKS_PER_SEC.

Типы данных

clock_t

Возвращается функцией clock(). Обычно определён как int или long int.

time_t

Возвращается функцией time(). Обычно определён как int или long int.

struct tm

Нелинейное, дискретное календарное представление времени.

Пример использования

Вывод на экран текущего времени.

# include <stdio.h>
# include <time.h>
 
int main(void)
{
  const time_t timer = time(NULL);
  printf("%s\n", ctime(&timer));
  return 0;
}

Примечания

1. ↑ Интервал допускает наличие секунды координации. http://en.cppreference.com/w/cpp/chrono/c/tm

Ссылки

• time.h — основные определения, The Single UNIX® Specification, выпуск 7 от The Open Group  (англ.)