Основы программирования в Linux

<b>#include &lt;time.h&gt;</b>
<b>struct tm *localtime(const time_t *timeval);</b>
Функция 
localtime
 идентична функции 
gmtime
 за исключением того, что она возвращает структуру, содержащую значения с поправками на местный часовой пояс и действующее летнее время. Если вы выполните программу 
gmtime
, но замените все вызовы функции 
gmtime
 на вызовы 
localtime
, в отчете программы вы увидите правильные время и дату.
Для преобразования разделенной на элементы структуры tm в общее внутреннее значение времени можно применить функцию 
mktime
:
<b>#include &lt;time.h&gt;</b>
<b>time_t mktime(struct tm *timeptr);</b>
Функция 
mktime
 вернет -1, если структура не может быть представлена как значение типа 
time_t
.
Для вывода программой 
date
 "дружественных" (в противоположность машинному) времени и даты можно воспользоваться функциями 
asctime
 и 
ctime
:
<b>#include &lt;time.h&gt;</b>
<b>char *asctime(const struct tm *timeptr);</b>
<b>char *ctime(const time_t *timeval);</b>
Функция 
asctime
 возвращает строку, представляющую время и дату, заданные 
tm
-структурой 
timeptr
. У возвращаемой строки формат, подобный приведенному далее:
Sun Jun  9 12:34:56 2007\n\0
У нее всегда фиксированный формат длиной 26 символов. Функция 
ctime
 эквивалентна следующему вызову:
asctime(localtime(timeval))
Она принимает необработанное машинное значение времени и преобразует его в местное время.
А теперь выполните упражнение 4.8.
Упражнение 4.8. Функция 
ctime
В этом примере благодаря приведенному далее программному коду вы увидите функцию 
ctime
 в действии.
#include &lt;time.h&gt;
#include &lt;stdio.h&gt;
#include &lt;stdlib.h&gt;
int main() {
 time_t timeval;
 (void)time(&amp;timeval);
 printf (&quot;The date is: %s&quot;, ctime(&amp;timeval));
 exit(0);
}
Откомпилируйте и затем запустите на выполнение ctime.c, и вы увидите нечто похожее на приведенные далее строки:
$ <b>./ctime</b>
The date is: Sat Jun 9 08:02:08 2007.
Как это работает
Программа ctime.c вызывает функцию 
time
 для получения машинного значения времени и дает возможность функции 
ctime
 выполнить всю тяжелую работу по преобразованию этого значения в удобочитаемую строку, которую потом и выводит на экран.
 
Для лучшего управления точным форматированием времени и даты ОС Linux и современные UNIX-подобные системы предоставляют функцию 
strftime
. Она довольно похожа на функцию 
sprintf
 для дат и времени и действует аналогичным образом:
<b>#include &lt;time.h&gt;</b>
<b>size_t strftime(char *s, size_t maxsize, const char *format, struct tm *timeptr);</b>
Функция 
strftime
 форматирует время и дату, представленные в структуре 
tm
, на которую указывает параметр, 
timeptr
, и помещает результат в строку 
s
. Эта строка задается длиной 
maxsize
 (как минимум) символов. Строка 
format
 применяется для управления символами, записываемыми в строку. Как и в функции 
printf
, она содержит обычные символы, которые будут переданы в строку, и спецификаторы преобразований для форматирования элементов времени и даты. В табл. 4.3 перечислены используемые спецификаторы преобразований.
Таблица 4.3
 
 
Спецификатор преобразования
 
Описание
 
 
 
%a
 
Сокращенное название дня недели
 
 
 
%А
 
Полное название дня недели
 
 
 
%b
 
Сокращенное название месяца
 
 
 
%B
 
Полное название месяца
 
 
 
%c
 
Дата и время
 
 
 
%d
 
День месяца, 01–31
 
 
 
%H
 
Час, 00–23
 
 
 
%I
 
Час по 12-часовой шкале, 01–12
 
 
 
%j
 
День в году, 001–366
 
 
 
%m
 
Номер месяца в году, 01–12
 
 
 
%M
 
Минуты, 00–59
 
 
 
%p
 
a.m. (до полудня) или p.m. (после полудня)
 
 
 
%S
 
Секунды, 00–59
 
 
 
%u
 
Номер дня недели, 1–7 (1 соответствует понедельнику)
 
 
 
%U
 
Номер недели в году, 01–53 (воскресенье — первый день недели)
 
 
 
%V
 
Номер недели в году, 01–53 (понедельник — первый день недели)
 
 
 
%w
 
Номер дня недели, 0–6 (0 соответствует воскресенью)
 
 
 
%x
 
Дата в региональном формате
 
 
 
%X
 
Время в региональном формате
 
 
 
%y
 
Номер года, меньший 1900
 
 
 
%Y
 
Год
 
 
 
%Z
 
Название часового пояса
 
 
 
%%
 
Символ 
%