timespec_get, , _timespec32_get_timespec64_get

Устанавливает интервал, на который указывает первый аргумент, в текущее календарное время в соответствии с заданной базой времени.

Синтаксис

int timespec_get(
    struct timespec* const time_spec,
    int const base
);
int _timespec32_get(
    struct _timespec32* const time_spec,
    int const base
);
int _timespec64_get(
    struct _timespec64* const time_spec,
    int const base
);

Параметры

time_spec
Указатель на структуру, которой присваивается время в секундах и наносекундах с начала эпохи.

base
Зависящее от реализации ненулевое значение, определяющее базу времени.

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

Значение base , если функция выполнена успешно; в противном случае возвращает ноль.

Замечания

Функция timespec_get присваивает текущее время структуре, на которую указывает аргумент time_spec . Все версии этой структуры имеют два члена: tv_sec и tv_nsec. Члену tv_sec присваивается целое число секунд, а члену tv_nsec — целое число наносекунд, округленное до разрешения системных часов, с начала эпохи, указанной в параметре base.

Блок, относящийся только к системам Майкрософт

Эти функции допускают только TIME_UTC в качестве значения base . TIME_UTCtime_spec Задает значение числа секунд и наносекунд с начала эпохи, полуночи, 1 января 1970 года, согласованное универсальное время (UTC). В _timespec32значение tv_sec имеет тип __time32_t . В _timespec64значение tv_sec имеет тип __time64_t . В timespecзначение tv_sec имеет тип time_t длиной 32 или 64 бита в зависимости от того, определен ли макрос препроцессора _USE_32BIT_TIME_T. Функция timespec_get — это встроенная функция, которая вызывает _timespec32_get , если _USE_32BIT_TIME_T определена; в противном случае она вызывается _timespec64_get.

End Microsoft Specific

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Дополнительные сведения о совместимости см. в разделе Совместимость.

См. также

Управление временем
asctime, _wasctime
asctime_s, _wasctime_s
_ftime, , _ftime32_ftime64
gmtime, , _gmtime32_gmtime64
gmtime_s, , _gmtime32_s_gmtime64_s
localtime, , _localtime32_localtime64
localtime_s, , _localtime32_s_localtime64_s
time, , _time32_time64
_utime, , _utime32_wutime_utime64_wutime32,_wutime64