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).

---

Функция 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 системной библиотеки