localtime_r()

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

Прототип:

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

Аргументы:

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

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

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

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

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

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

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

POSIX 1003.1 Thread-Safe Functions

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

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

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

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