localtime()

Преобразовать системное время в локальное

Прототип:

#include <time.h>
struct tm * localtime( const time_t *timer );

Аргументы:

timer
Указатель на переменную типа time_t, содержащую системное время, которое требуется преобразовать.

Библиотека:

libc

Описание:

Функция localtime_r() преобразовывает системное время, указанное в timer в локальное (местное) время, сохраняя информацию в структуре struct tm. Вызов функции localtime_r() вызывает функцию tzset().

Системное время обычно получают через вызов time(). Это т.н. время Coordinated Universal Time (UTC, также известное как время по Гринвичу, Greenwich Mean Time или GMT).


Note: Функция localtime() помещает сконвертированное ввремя в структуру struct tm, которая переиспользуется каждый раз при вызове localtime() или gmtime(). Вызов asctime() или ctime() также может изменить данные в этом статическом буфере.

В многопоточных приложениях рекомендуется использовать localtime_r().


Обычно используется утилита date для установки на компьютере системного времени в UTC. Переменная TZ или строка конфигурации _CS_TIMEZONE используются для установки локального времени (местного часового пояса).

Возвращаемое значение:

Указатель на struct tm.

Классификация:

ANSI, POSIX 1003.1

Безопасность использования
Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Нет

Тематические ссылки:

time_t, asctime(), asctime_r(), clock(), ctime(), ctime_r(), difftime(), gmtime(), gmtime_r(), mktime(), localtime_r(), strftime(), time(), struct tm, tzset()




Предыдущий раздел: Описание API системной библиотеки