13.10 time.h

In dieser Datei sind Funktionen für den Umgang mit Datum und Uhrzeit definiert. Einige Funktionen benutzen den Datentyp tm, der den unten aufgeführten Aufbau hat. Die Komponente tm_isdst ist positiv, wenn Sommerzeit gilt, 0 wenn keine Sommerzeit gilt und negativ, wenn diese Information nicht zur Verfügung steht. Die restlichen Komponenten sollten mit dem Kommentar selbsterklärend sein.

Man muß unterscheiden, ob eine Funktion die Kalenderzeit, die z.B. keine Zeitzonen berücksichtigt, oder die Ortszeit benutzt. Die Kalenderzeit, die in einen Datentyp time_t geschrieben wird, ist üblicherweise die Anzahl Sekunden seit dem 1.1.1970, also dem ersten 1.1 seit dem Bestehen von UNIX.

struct tm
{
    int tm_sec;   /* Sekunden nach der vollen Minute -- [0,  59] */
    int tm_min;   /* Minuten nach der vollen Stunde  -- [0,  59] */
    int tm_hour;  /* Stunden nach Mitternacht        -- [0,  23] */
    int tm_mday;  /* Tag im Monat                    -- [1,  31] */
    int tm_mon;   /* Monate seit Januar              -- [0,  11] */
    int tm_year;  /* Jahre seit 1900                 -- [      ] */
    int tm_wday;  /* Tage seit Sonntag               -- [0,   6] */
    int tm_yday;  /* Tage seit 1. Januar             -- [0, 365] */
    int tm_isdst; /* Kennzeichen für Sommerzeit                  */
};

char *asctime( const struct tm *tblock );

Diese Funktion erzeugt aus der Zeit in tblock eine Zeichenkette, in der die Zeit in der Form "Sun Jan 3 15:14:13 1988\n" abgelegt ist. Wenn dieses Format nicht erwünscht ist, kann strftime benutzt werden.
 

char *ctime( const time_t *timer );

Diese Funktion gibt die Kalenderzeit in timer als Ortszeit in einem String aus. Damit ist die Funktion äquivalent zu asctime(localtime(timer));
 

struct tm *gmtime( const time_t *clock );

Diese Funktion wandelt die Kalenderzeit in tp in die Coordinated Universal Tiem (UTC).
 

struct tm *localtime( const time_t *clock );

Diese Funktion wnadlet die Kalenderzeit in clock in die Ortszeit.
 

time_t time( time_t *timer );

Diese Funktion liefert die aktuelle Kalenderzeit. Wenn timer ungleich NULL ist, wird der Wert auch in die Variable geschrieben, auf die timer zeigt.
 

time_t mktime( struct tm *timeptr );

Diese Funktion wandelt die Ortszeit in timeptr in die Kalenderzeit um.
 

clock_t clock( void );

Diese Funktion liefert die Systemticks, die das Programm seit dem Start verbraucht hat. Die Konstante CLOCKS_PER_SEC liefert die Zahl Systemticks pro Sekunde.
 

size_t strftime( char *s, size_t max_size, const char *format, const struct tm *timeptr );

Diese Funktion wandelt die Zeit aus timeptr gemäß dem Formatstring format in einen String um, der nach s kopiert wird. Der Parameter max_size gibt dabei an, wieviel Zeichen s maximal fassen kann. Analog zu printf werden gewöhnliche Zeichen nach s übernommen und Platzhalter für strftime, die aus dem Prozentzeichen gefolgt von einem Buchstaben bestehen, werden durch den entsprechenden Wert aus der Struktur timeptr ersetzt.
 

double difftime( time_t time2, time_t time1 );

Diese Funktion liefert die Differenz von time2-time1 in Sekunden.
 

• 13.10.1 Platzhalter für strftime

English version not yet available.