time(5)                                                             time(5)

NAME
     time - Typen für Datum und Uhrzeit

SYNTAX
     #include <time.h>

BESCHREIBUNG
     Die Include-Datei <time.h> deklariert die Struktur tm, die zumindest
     folgende Komponenten enthält:

     int tmsec      Sekunden [0,61]
     int tmmin      Minuten [0,59]
     int tmhour     Stunden [0,23]
     int tmmday     Tag im Monat [1,31]
     int tmmon      Monat im Jahr [0,11]
     int tmyear     Jahr seit 1900
     int tmwday     Wochentag [0,6] (Sonntag = 0)
     int tmyday     Tag im Jahr [0,365]
     int tmisdst    Flag für Sommerzeit

     Der Wert tmisdst ist positiv, wenn die Sommerzeit gilt. Andernfalls
     ist der Wert 0. Ein negativer Wert bedeutet, daß keine Angaben zur
     Sommerzeit verfügbar sind.

     Diese Include-Datei definiert die folgenden symbolischen Namen:

     NULL                Nullzeigerkonstante.

     CLKTCK             Anzahl der Zeittakte (Ticks) der Systemuhr pro
                         Sekunde, die von der Funktion times() zurückgege-
                         ben werden.

     CLOCKSPERSEC      Eine Zahl, die verwendet wird, um den von der
                         Funktion clock() zurückgegebenen Wert in Sekunden
                         umzusetzen.

     Die Typen clockt, sizet und timet sind wie in <sys/types.h>
     beschrieben definiert.

     Bei allen XSI-kompatiblen Systemen (XSI - X/Open System Interface) muß
     der Wert CLOCKSPERSEC zwar 1 Million sein, bei anderen Systemen kann
     er aber variieren. Es darf nicht davon ausgegangen werden, daß
     CLOCKSPERSEC eine Konstante für die Kompilierzeit ist.

     Der Wert CLKTCK entspricht derzeit dem Wert sysconf(SCCLKTCK); bei
     neueren Anwendungen sollte allerdings sysconf() aufgerufen werden, da
     das Makro CLKTCK wieder zurückgenommen wird.

     Die Include-Datei <time.h> enthält eine Deklaration für getdateerr.






Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

time(5)                                                             time(5)

     Die Include-Datei <time.h> enthält folgende Funktionsprototypen, die
     auch als Makro definiert sein können:

     char      *asctime(const struct tm *timeptr);
     clockt    clock(void);
     char      *ctime(const timet *clock);
     double     difftime(timet time1, timet time0);
     struct tm *getdate(const char *string);
     struct tm *gmtime(const timet *timer);
     struct tm *localtime(const timet *timer);
     timet     mktime(struct tm *timeptr);
     sizet     strftime(char *s, sizet maxsize, const char *format,
                         const struct tm *timptr);
     char      *strptime(const char *buf, const char *format,
                         struct tm *tm);
     timet     time(timet *tloc);
     void       tzset(void);

     Die folgenden Funktionsprototypen sind als Variablen deklariert:

     extern int      daylight;
     extern long int timezone;
     extern char    *tzname[];

ANWENDUNGSZWECK
     Bei dem Bereich [0,61] für tmsec ist eine gelegentlich auftretende
     Schaltsekunde (Leap Second) oder doppelte Schaltsekunde (Double Leap
     Second) berücksichtigt.

SIEHE AUCH
     utime(2), time(2), asctime(3C), clock(3C), ctime(3C), daylight(3C),
     difftime(3C), getdate(3C), gmtime(3C), localtime(3C), mktime(3C),
     strftime(3C), strptime(3C), sysconf(3C), timezone(3C), tzname(3C),
     tzset(3C), systime(5).




















Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98