Функция 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 <time.h>
char *asctime(const struct tm *timeptr);
Возвращает при успешном завершении указатель на статически размещенную строку, оканчивающуюся символом новой строки и \0, или NULL при ошибке
В отличие от функции ctime(), установки часового пояса не влияют на работу функции asctime(), поскольку она выполняет преобразование разделенного времени, которое является либо уже локализованным благодаря использованию функции localtime(), либо временем UTC, возвращенным функцией gmtime().
Как и в случае применения функции ctime(), у нас нет средств для управления форматом строки, создаваемой функцией asctime().
Реентерабельная версия функции asctime() предоставляется в виде asctime_r().
В листинге 10.1 показывается пример использования функции asctime(), а также всех рассмотренных до сих пор в этой главе функций преобразования времени. Программа извлекает текущее календарное время, а затем использует различные функции преобразования времени и выдает результаты их работы. Далее приведен пример того, что будет показано при запуске этой программы в Мюнхене, Германия, где (зимой) применяется центральноевропейское время, на один час больше UTC:
$ date
Tue Dec 28 16:01:51 CET 2010
$ ./calendar_time
Seconds since the Epoch (1 Jan 1970): 1293548517 (about 40.991 years)
gettimeofday() returned 1293548517 secs, 715616 microsecs
Broken down by gmtime():
year=110 mon=11 mday=28 hour=15 min=1 sec=57 wday=2 yday=361 isdst=0
Broken down by localtime():
year=110 mon=11 mday=28 hour=16 min=1 sec=57 wday=2 yday=361 isdst=0
asctime() formats the gmtime() value as: Tue Dec 28 15:01:57 2010
ctime() formats the time() value as: Tue Dec 28 16:01:57 2010
mktime() of gmtime() value: 1293544917 secs
mktime() of localtime() value: 1293548517 secs На 3600 секунд больше UTC