ftime

Nach oben zu sys\timeb.h - Index

Header-Datei

sys\timeb.h

Kategorie

Uhrzeit- und Datumsroutinen

Prototyp

void ftime(struct timeb *buf)

Beschreibung

Speichert die aktuelle Uhrzeit in der Struktur timeb.

Auf UNIX-Plattformen ist ftime nur bei System V-Systemen verfügbar.

ftime ermittelt die aktuelle Uhrzeit und füllt die Felder der timeb-Struktur, auf die buf zeigt. Die Struktur timeb enthält vier Felder: time, millitm, _timezone und dstflag:

struct timeb {

long time ;

short millitm ;

short _timezone ;

short dstflag ;

};

• time gibt die Zeit in Sekunden seit dem 1. Januar 1970, 00:00:00 Greenwich-Mean-Zeit (GMT) an.
• millitm ist der fraktionale Teil einer Sekunde in Millisekunden.
• _timezone ist die Differenz zwischen GMT und der lokalen Zeit in Minuten. Dieser Wert wird von GMT aus nach Westen gehend berechnet. ftime ermittelt den Feldwert aus der globalen Variable _timezone, die über tzset gesetzt wird.
• dstflag wird auf einen Wert ungleich Null gesetzt, wenn bei der Zeitberechnung die Sommerzeit berücksichtigt werden muss.

Anmerkung:  ftime ruft tzset auf. Daher müssen Sie nicht selbst tzset aufrufen, wenn Sie ftime verwenden.

Rückgabewert

Keiner.

Beispiel

 #include <stdio.h>
 #include <stdlib.h>
 #include <time.h>
 #include <sys\timeb.h>
 /* Pazifik-Standard- und -Sommerzeit */
 char *tzstr = "TZ=PST8PDT";
 int main(void)
 {
    struct timeb t;
    putenv(tzstr);
    tzset();
    ftime(&t);
    printf("Seconds since 1/1/1970 GMT: %ld\n", t.time);
    printf("Thousandths of a second: %d\n", t.millitm);
    printf("Difference between local time and GMT: %d\n", t._timezone);
    printf("Daylight savings in effect (1) not (0): %d\n", t.dstflag);
    return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+