timespec_get, _timespec32_get_timespec64_get

Legt das Intervall, auf das das erste Argument verweist, auf die aktuelle Kalenderzeit fest, basierend auf der angegebenen Zeitbasis.

Syntax

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

Parameter

time_spec
Zeiger auf eine Struktur, die auf die seit dem Beginn der Epoche verstrichene Zeit in Sekunden und Nanosekunden festgelegt ist.

base
Ein implementierungsspezifischer Wert ungleich null, der die Zeitbasis angibt.

Rückgabewert

Der Wert von base im Erfolgsfall, andernfalls wird null zurückgegeben.

Hinweise

Die timespec_get -Funktionen legen die aktuelle Zeit in der Struktur fest, auf die das time_spec -Argument verweist. Alle Versionen dieser Struktur besitzen zwei Member, tv_sec und tv_nsec. Der tv_sec -Wert ist auf die ganze Anzahl der Sekunden, und tv_nsec auf ganzzahlige Nanosekunden festgelegt, auf die Auflösung der Systemuhr gerundet, seit dem durch baseangegebenen Beginn der Epoche.

Microsoft-spezifisch

Diese Funktionen unterstützen nur TIME_UTC als Wert von base . TIME_UTC legt den time_spec Wert auf die Anzahl der Sekunden und Nanosekunden seit dem Epochenanfang, Mitternacht, 1. Januar 1970, koordinierte Weltzeit (UTC) fest. In einer _timespec32ist tv_sec ein __time32_t -Wert. In einer _timespec64ist tv_sec ein __time64_t -Wert. In einer timespecist tv_sec ein time_t -Typ, der eine Länge von 32 Bit oder 64 Bit aufweist, abhängig davon, ob das Präprozessormakro _USE_32BIT_TIME_T definiert ist. Die timespec_get Funktion ist eine Inlinefunktion, die aufruft _timespec32_get , wenn _USE_32BIT_TIME_T sie definiert ist; andernfalls wird sie aufgerufen _timespec64_get.

End Microsoft Specific

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Anforderungen

Routine	Erforderlicher Header
timespec_get, _timespec32_get_timespec64_get	C: time.h>, C++: <<ctime> oder <time.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

Zeitverwaltung
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_utime64, _wutime, , _wutime32_wutime64