int gettimeofday(struct timeval *, struct timezone *);

Функция gettimeofday() определена в заголовочном файле sys/time.h. Как многие другие функции с префиксом get, у неё есть комплементарная функция settimeofday().

Параметры:

timeval Это указатель на структуру, к которой содержатся 2 поля: tv_sec (тип time_t) и tv_usec (тип suseconds_t). В поле tv_sec присутствует абсолютное количество секунд, прошедших с момента 1 января 1970 года. В поле tv_usec содержит добавочное количество микросекунд, которое не включено в значение time_t tv_sec.

struct timeval {
   time_t      tv_sec;  /* количество секунд */
   suseconds_t tv_usec; /* и микросекунд */
};

timezone Это указатель на структуру, где содержатся 2 поля, соответствующие информации временной зоны: int tz_minuteswest, значение в минутах западнее от GMT для текущей зоны времени, и поле int tz_dsttime, где указано количество часов для подстройки коррекции летнего времени (daylight saving time). Эти подробности недоступны в других функциях обработки времени.

struct timezone {
   int tz_minuteswest;  /* сколько минут к западу от Гринвича (GMT) */
   int tz_dsttime;      /* тип коррекции летнего времени */
};

Возвращаемое значение: gettimeofday() вернет 0 в случае успеха, и -1 в случае ошибки, и в этом случае будет установлена переменная errno.

Пример программы для тестирования функции gettimeofday():

#include < stdio.h>

#include < sys/time.h>

int main()
{
   struct timeval tv;
   struct timezone tz;

   gettimeofday(&tv,&tz);

   printf("Сколько секунд прошло от 1/1/1970: %lu\n", tv.tv_sec);
   printf("... и микросекунд: %d\n", tv.tv_usec);
   printf("Минут западнее Гринвича: %d\n", tz.tz_minuteswest);
   printf("Коррекция летнего времени: %d час\n",tz.tz_dsttime);

   return(0);
}

В качестве временного хранилища вычисляемых значений здесь определены локальные переменные tv и tz. Если декларировать их как указатели, то нужно гарантировать, что им присвоены адреса на выделенные области в памяти. В функцию gettimeofday можно передать и нулевые указатели (NULL), в этом случае функция не будет вычислять и заполнять значения для timeval и timezone.

Пример вывода этой программы:

Сколько секунд прошло от 1/1/1970: 1685491200
... и микросекунд: 613564
Минут западнее Гринвича: 480
Коррекция летнего времени: 1 час

Очевидно, результаты такого вывода не всегда полезны для практического применения. Усовершенствованный вариант кода:

#include < stdio.h>

#include < sys/time.h>

#include < time.h>

int main()
{
   struct timeval tv;
   struct timezone tz;
   struct tm *today;
   int zone;

   gettimeofday(&tv,&tz);

   /* Отображение времени в удобном формате: */
   today = localtime(&tv.tv_sec);
   printf("%d:%0d:%0d.%d\n",
            today->tm_hour,
            today->tm_min,
            today->tm_sec,
            tv.tv_usec);
   /* Установка временной зоны на часы, не минуты: */
   zone = tz.tz_minuteswest/60;
   /* Вычисление для зон восточнее GMT: */
   if( zone > 12 )
      zone -= 24;
   printf("Зона времени: GMT %+d\n", zone);
   printf("Коррекция летнего времени: %d час\n", tz.tz_dsttime);

   return(0);
}

Здесь добавлена функция localtime(), чтобы обработать значение time_t из tv.tv_sec. Это значение транслируется в формат hh:mm:ss, и также выводится добавочное значение микросекунд.

Временная зона из tz.tz_minuteswest сохраняется в переменную zone, и корректируется с учетом случая, когда зона находится восточнее Гринвича. This result is output at Line 27. Формат %+d обеспечивает вывод для значения зоны префикса знака + или –.

Пример вывода этого кода:

10:15:23.952229
Зона времени: GMT +8
Коррекция летнего времени: 1

#include < time.h>

time_t time(time_t *t);

Возвращает время в секундах, прошедшее с начала этой эпохи (00:00:00 UTC, 1 Января 1970 года). Если t не равно NULL, то возвращаемое значение будет также сохранено в памяти структуры t. При ошибке возвращается max(time_t)-1, а в переменной errno код ошибки.

#include < time.h>

char *asctime(const struct tm *tm);

char *asctime_r(const struct tm *tm, char *buf);

char *ctime_r(const time_t *timep, char *buf);

char *ctime(const time_t *timep);

struct tm *gmtime(const time_t *timep);

struct tm *gmtime_r(const time_t *timep, struct tm *result);

struct tm *localtime(const time_t *timep);

struct tm *localtime_r(const time_t *timep, struct tm *result);

time_t mktime(struct tm *tm);

Функции ctime(), gmtime() и localtime() в качестве аргумента используют тип данных time_t , представляющий собой календарное время. Функции интерпретируют его как абсолютное время, содержащее количество секунд, прошедших с 00:00:00 1 января 1970 года времени UTC.

Функции asctime() и mktime() используют в качестве аргумента локальное время в календарном представлении, то есть разделенное на год, месяц, день и т.д. Время в календарном представлении хранится в структуре tm, которая определена в файле time.h следующим образом:

struct tm {
   int tm_sec;         /* секунды */
   int tm_min;         /* минуты */
   int tm_hour;        /* часы */
   int tm_mday;        /* день месяца */
   int tm_mon;         /* месяц */
   int tm_year;        /* год */
   int tm_wday;        /* день недели */
   int tm_yday;        /* день года */
   int tm_isdst;       /* летнее время */
};

Члены структуры tm:

tm_sec Число секунд, прошедших после минуты, обычно в диапазоне от 0 до 59; но для того, чтобы установить високосную секунду, используются числа до 61.

tm_min Число минут, прошедших после часа, от 0 до 59.

tm_hour Количество прошедших часов после полуночи, от 0 до 23.

tm_mday День месяца, от 1 до 31.

tm_mon Число месяцев, прошедших с января, от 0 до 11.

tm_year Число лет, прошедших с 1900.

tm_wday Число дней, прошедших с воскресенья, от 0 до 6.

tm_yday Количество дней, прошедших с 1 января, от 0 до 365.

tm_isdst Этот флаг показывает, в действительности ли "летнее" время учтено в этой структуре. Значение флага положительно, если "летнее" время учитывается, 0, если нет, и отрицательно, если информация недоступна.

Функция ctime(t) является эквивалентом asctime(localtime(t)). Она преобразует календарное время t в строку формата:

"Wed Jun 30 21:49:08 1993\n"

Аббревиатуры дней недели: `Sun', `Mon', `Tue', `Wed', `Thu', `Fri' и `Sat'. Аббревиатуры месяцев: `Jan', `Feb', `Mar', `Apr', `May', `Jun', `Jul', `Aug', `Sep', `Oct', `Nov' и `Dec'. Возвращаемое значение указывает на статически размещенную строку, которая может быть заново записана с помощью последовательности вызовов любых функций даты и времени. Функция также устанавливает значение внешней переменной tzname (см. tzset()) равным значению текущей временной зоны. Реентрантная версия ctime_r() делает то же самое, но заносит строку в буфер, предоставляемый пользователем. Длина буфера должна быть не менее 26 байт. Устанавливать tzname необязательно.

Функция gmtime() преобразует календарное время в локальное представление времени, определенное во всеобщем скоординированном времени (UTC). Но она может вернуть значение NULL, если год не может быть описан типом int. Возвращаемое значение указывает на статически выделенную структуру, содержимое которой может быть перезаписано последующими вызовами любых функций, работающих с датой и временем. Функция gmtime_r() делает то же самое, но помещает данные в структуру, предоставленную пользователем.

Функция localtime() преобразует календарное время в локальное, определенное в соответствии с заданной пользователем временной зоной. Функция работает так, как будто она вызывает tzset(), и устанавливает внешние переменные: tzname в значение текущей временной зоны, timezone в значение разницы в секундах между всеобщим скоординированным временем (UTC) и локальным стандартом времени и daylight в ненулевое значение, если используются стандартные правила "летнего" времени. Возвращаемое значение указывает на статически выделенную структуру, содержимое которой может быть перезаписано последующими вызовами любых функций, работающих с датой и временем. Функция localtime_r() делает то же самое, но помещает данные в структуру, предоставленную пользователем. Она не нуждается в установке tzname.

Функция asctime() преобразует значение локального времени tm в строку того же формата, что и функция ctime(). Возвращаемое значение указывает на статическую строку, которая может быть перезаписана последовательностью вызовов любых функций даты и времени. Функция asctime_r() делает то же самое, но заносит строку в буфер, предоставленный пользователем. Длина буфера должна быть не менее 26 байт.

Функция mktime() преобразует время в календарном представлении в абсолютное время. Функция игнорирует содержимое полей структуры tm_wday и tm_yday и пересчитывает их значения в соответствии с другими элементами структуры. Если значения элементов структуры выходят за пределы допустимых значений, то они "нормализуются" (так, например, 40 октября превращается в 9 ноября). Вызов mktime() также присваивает внешней переменной tzname значение текущей временной зоны. Если локальное время не может быть представлено как календарное (число секунд с начала века), то mktime() возвращает значение max(time_t)-1 и не изменяет значения членов структуры локального времени tm_wday и tm_yday.

Возвращаемое значение: в случае успеха все вышеперечисленные функции возвращают описанное значение, или NULL (-1 для mktime()) при возникновении ошибки.

#include < time.h>clock_t clock(void);

Функция clock() возвращает суммарное процессорное время, использованное программой. Возвращаемое значение - это время, затраченное процессором на выполнение программы, представленное типом clock_t. Чтобы узнать количество затраченных на выполнение секунд, разделите возвращенное значение на CLOCKS_PER_SEC. Если затраченное процессором время недоступно или если его значение не может быть определено, то функция возвращает значение max(clock_t)-1.

#include < time.h>double difftime (time_t time1 time_t time0);

Возвратит разницу в секундах между двумя абсолютными метками времени (time1 - time0).

size_t strftime (char *buf, size_t maxsize, const char *fmt, const struct tm *tm);

Функция берет информацию из структуры tm, и преобразует её в текст и помещает в буфер buf. Для преобразования используется формат, указанный параметром fmt. Формат состоит из 0 или большего количества спецификаторов формата и обычных символов. Все обычные функции копируются напрямую в выходной буфер buf. Спецификаторы преобразования состоят из знака процента (%) и одного из символов формата (см. список форматов далее).

В выходной буфер не может быть помещено больше чем maxsize символов. Если общее количество символов выходного результата, включая завершающий '\0', не превышает maxsize, то strftime() вернет количество полезных символов в этом массиве, не включая завершающий '\0'. Иначе будет возвращен 0, и состояние выходного буфера будет неопределенное.

Спецификаторы формата преобразования:

%A Заменяется национальным представлением полного имени дня недели.

%a Заменяется аббревиатурой национального представления имени дня недели.

%B Заменяется национальным представлением полного имени месяца.

%b Заменяется аббревиатурой национального представления имени месяца.

%C Заменяется на (год / 100) в виде десятичного числа; одиночным цифрам предшествует 0.

%c Заменяется национальным представлением времени и даты.

%D Эквивалент "%m/%d/%y".

%d Заменяется днем месяцы в виде десятичного числа (01 .. 31).

%E*%O* Расширения локали POSIX. Поддерживаются последовательности %Ec %EC %Ex %EX %Ey %EY %Od %Oe %OH %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy для альтернативных представлений преобразования. Дополнительно реализовано %OB для представления альтернативных названий месяцев (используется автономно, без указания дня).

%e Заменяется днем месяца в виде десятичного числа (1 .. 31); одиночным цифрам предшествует пробел.

%F Эквивалентно "%Y-%m-%d".

%G Заменяется на год в виде десятичного числа с веком (4 десятичные цифры). Значение года содержит большую часть недели (понедельник как первый день недели).

%g Заменяется таким же годом, как и с использованием %G, но без десятичого числа века (00 .. 99).

%H Заменяется на значение часа (24-часовое представление) в виде десятичного числа (00 .. 23).

%h То же самое, что и %b.

%I Заменяется на значение часа (12-часовое представление) в виде десятичного числа (01 .. 12).

%j Заменяется на день года (001 .. 366).

%k Заменяется на значение часа (24-часовое представление) в виде десятичного числа (0 .. 23); одиночным цифрам предшествует пробел.

%l Заменяется на значение часа (12-часовое представление) в виде десятичного числа (1 .. 12); одиночным цифрам предшествует пробел.

%M Заменяется на значение минут (00 .. 59).

%m Заменяется на значение месяца (01 .. 12).

%n Заменяется на перевод строки.

%O* То же самое, что и %E*.

%p Заменяется национальным представлением либо "ante meridiem" (AM), либо "post meridiem" (PM), в зависимости от обстоятельств.

%R Эквивалент "%H:%M".

%r Эквивалент "%I:%M:%S %p".

%S Заменяется значением секунд (00 .. 60).

%s Заменяется на значение секунд, прошедших от Epoch, UTC (см. описание mktime).

%T Эквивалент "%H:%M:%S".

%t Заменяется символом табуляции.

%U Заменяется на номер недели года (воскресенье Sunday как первый день недели) в виде десятичного числа (00 .. 53).

%u Заменяется днем недели (понедельник Monday как первый день недели) в виде десятичного числа (1 .. 7).

%V Заменяется на номер недели года понедельник Monday как первый день недели) в виде десятичного числа (01 .. 53). Если неделя, содержащая 1 января, имеет 4 или большее количество дней в новом году, то эта неделя 1; иначе это последняя неделя предыдущего года, и следующая неделя будет неделей 1.

%v Эквивалент "%e-%b-%Y".

%W Заменяется на номер недели кода (понедельник Monday как первый день недели) в виде десятичного числа (00 .. 53).

%w Заменяется на день недели (воскресенье Sunday как первый день недели) в виде десятичного числа (0 .. 6).

%X Заменяется на национальное представление времени.

%x Заменяется на национальное представление даты.

%Y Заменяется на год с сотнями лет в виде десятичного числа из 4 цифр.

%y Заменяется на год без указания сотен лет в виде десятичного числа (00 .. 99).

%Z Заменяется на имя зоны времени.

%z Заменяется на смещение зоны времени от UTC; начальный знак плюса обозначает смещение на восток от UTC, а минус на запад от UTC. Значения часов и минут далее представляются 2 цифрами каждое, без разделителя между ними (общая форма для заголовков даты RFC, RFC 822 date headers).

%+ Заменяется национальным представлением даты и времени (формат подобен тому, как его генерирует date).

%-* Расширение GNU libc. Не делать никакое дополнение слева, когда выполняется любой числовой вывод.

%_* Расширение GNU libc. Явно указывает пробел для дополнения слева.

%0* Расширение GNU libc. Явно указывает 0 для дополнения слева.

%% Заменяет символ процента (%). 

#include < sys/time.h>

int adjtime (const struct timeval *delta, struct timeval *olddelta);

Корректирует время, чтобы позволить синхронизацию системных часов.

Системный вызов, выполняющий небольшую коррекцию системного времени, которое возвращается из gettimeofday(). Происходит замедление или ускорение времени, как это указано параметром timeval *delta. Если *delta отрицательное, то часы замедляются путем более медленного инкремента, пока не завершится коррекция. Если *delta положительное, то нормально используется увеличенный инкремент. Шаг, используемый для коррекции, обычно составляет доли процента. Таким образом, время всегда является монотонно возрастающей функцией. Коррекция времени из предыдущего вызова adjtime() не может быть завешено, когда adjtime() была вызвана повторно. Если olddelta не NULL, то структура, на которую указывает olddelta, на выходе будет заполнена количеством микросекунд, которое предстоит поправить из предыдущего вызова.

Функция adjtime может использоваться серверами времени, которые синхронизируют часы компьютеров локальной сети. Такие серверы времени замедляли бы часы одних машин и ускоряли бы часы других, чтобы подкорректировать их до среднего сетевого времени.