gettimeofday, gettimeofday64 - Datum und Uhrzeit lesen

Definition	#include <sys/time.h> int gettimeofday(struct timeval *tp, void *tzp); int gettimeofday64(struct timeval64 *tp, void *tzp);
Beschreibung	gettimeofday() und gettimeofday64() lesen die aktuelle Zeit für das System. Die aktuelle Zeit wird in verstrichenen Sekunden und Mikrosekunden seit dem 1. Januar 1970, 00:00 (Universal Time Coordinated ) angegeben. Die Auflösung der Systemuhr ist hardwareabhängig; die Zeit kann stetig oder in Zeittakten aktualisiert werden. tp zeigt auf eine Struktur vom Typ timeval bzw. timeval64, die folgende Komponenten enthält: long     tv_sec;      /* Sekunden seit dem 1. Januar 1970 */ bzw. time64_t tv_sec;      /* Sekunden seit dem 1. Januar 1970 */ und long     tv_usec;     /* und Mikrosekunden */ Wenn tp ein Nullzeiger ist, wird die aktuelle Zeit nicht gelesen. tzp muss ein Nullzeiger sein, sonst ist das Verhalten undefiniert. Die Umgebungsvariable TZ enthält Zeitzoneninformationen. Siehe timezone.
Returnwert	0	bei Erfolg.
	-1	bei Fehler.
Hinweise	Auf den Returnwert -1 im Fehlerfall sollten sich Programme, die portabel sein wollen, nicht verlassen.
Siehe auch	ctime(), ftime(), timezone, sys/time.h.