Linux API. Исчерпывающее руководство

Если определен макрос проверки возможностей _BSD_SOURCE, определяемая библиотекой glibc структура tm также включает два дополнительных поля с более подробной информацией о представленном времени. Первое из них, long int tm_gmtoff, содержит количество секунд, на которое представленное время отстоит на восток от UTC. Второе поле, const char *tm_zone, является сокращенным названием часового пояса (например, CEST для центральноевропейского летнего времени). Ни одно из этих полей в SUSv3 не упоминается, и они появляются лишь в нескольких других реализациях UNIX (в основном происходящих от BSD).

Функция mktime() преобразует местное время, разбитое на компоненты, в значение типа time_t, которое возвращается в качестве результата ее работы. Вызывающий код предоставляет разбитое на компоненты время в структуре tm, на которую указывает значение аргумента timeptr. В ходе этого преобразования поля tm_wday и tm_yday вводимой tm-структуры игнорируются.

#include

time_t mktime(struct tm *timeptr);

Возвращает при успешном завершении количество секунд, прошедшее с начала отсчета времени и соответствующее содержимому, на которое указывает timeptr, или значение (time_t) –1 при ошибке

Функция mktime() может изменить структуру, на которую указывает аргумент timeptr. Как минимум, она гарантирует, что для полей tm_wday и tm_yday будут установлены значения, соответствующие значениям других вводимых полей.

Кроме того, mktime() не требует, чтобы другие поля структуры tm ограничивались рассмотренными ранее диапазонами. Для каждого поля, чье значение выходит за границы диапазона, функция mktime() скорректирует это значение таким образом, чтобы оно попало в диапазон, и сделает соответствующие корректировки других полей. Все эти настройки выполняются до того, как mktime() обновляет значения полей tm_wday и tm_yday и вычисляет возвращаемое значение времени с типом time_t.

Например, если вводимое поле tm_sec хранило значение 123, тогда по возвращении из функции значением поля станет 3, а к предыдущему значению поля tm_min будет добавлено 2. (И если это добавление приведет к переполнению tm_min, значение tm_min будет скорректировано, увеличится значение поля tm_hour и т. д.) Эти корректировки применяются даже к полям с отрицательными значениями. Например, указание –1 для tm_sec означает 59-ю секунду предыдущей минуты. Данное свойство позволяет выполнять арифметические действия в отношении даты и времени, выраженных в виде отдельных компонентов.

При выполнении преобразования функцией mktime() используется настройка часового пояса. Кроме того, в зависимости от значения вводимого поля tm_isdst, функцией могут учитываться, а могут и не учитываться настройки летнего времени.

• Если поле tm_isdst имеет значение 0, это время рассматривается как стандартное (то есть настройки летнего времени игнорируются, даже если они должны применяться к данному времени года).

• Если поле tm_isdst имеет значение больше нуля, это время рассматривается с учетом перехода на режим летнего времени (то есть ведет себя, как будто режим летнего времени введен, даже если этого не должно быть в текущее время года).

• Если поле tm_isdst имеет значение меньше нуля, предпринимается попытка определить, должен ли режим летнего времени применяться в это время года. Обычно именно такая установка нам и требуется.

Перед завершением своей работы (и независимо от исходной установки значения tm_isdst) функция mktime() устанавливает для поля tm_isdst положительное значение, если режим летнего времени применяется в это время года, или нулевое значение, если он не применяется.

10.2.3. Преобразования между разделенным календарным временем и временем в печатном виде

В этом разделе мы рассмотрим функции, выполняющие преобразование разделенного календарного времени в печатный вид и наоборот.

Преобразование разделенного календарного времени в печатный вид

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

#include

char *asctime(const struct tm *timeptr);

Возвращает при успешном завершении указатель на статически размещенную строку, оканчивающуюся символом новой строки и \0, или NULL при ошибке

В отличие от функции ctime(), установки часового пояса не влияют на работу функции asctime(), поскольку она выполняет преобразование разделенного времени, которое является либо уже локализованным благодаря использованию функции localtime(), либо временем UTC, возвращенным функцией gmtime().

Как и в случае применения функции ctime(), у нас нет средств для управления форматом строки, создаваемой функцией asctime().

Реентерабельная версия функции asctime() предоставляется в виде asctime_r().