localtime_r()

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

Прототип:

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

Аргументы:

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

Библиотека:

libc

Описание:

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

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

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

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

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

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

POSIX 1003.1 TSF

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

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

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




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