Time.h

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,61)
int tm_min;	Минуты от начала часа(0,59)
int tm_hour;	Часы от полуночи(0,23)
int tm_mday;	Число месяца(1,31)
int tm_mon;	Месяцы после января(0,11)
int tm_year;	Годы с 1900
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()
{
 const time_t timer = time(NULL);
 printf("%s\n", ctime(&timer));
}

Ссылки

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