Eine Einführung in die Programmiersprache C und die Grundlagen ...

Eine Einführung in die Informatik und die Programmiersprache C
19.4 Funktionen für Datum und Uhrzeit:
Die Definitionsdatei vereinbart Typen und Funktionen zum Umgang mit Datum und
Uhrzeit. Manche Funktionen verarbeiten die Ortszeit, die von der Kalenderzeit zum Beispiel wegen
einer Zeitzone abweicht. clock_t und time_t sind numerische Typen, die Zeiten repräsentieren,
und struct tm enthält die Komponenten einer Kalenderzeit:
struct tm {
int tm_sec; Sekunden nach der vollen Minute (0, 61)*
int tm_min; Minuten nach der vollen Stunde (0, 59)
int tm_hour; Stunden seit Mitternacht (0, 23)
int tm_mday; Tage 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 dem 1. Januar (0, 365)
int tm_isdst; Kennzeichen für Sommerzeit
}
(*Die zusätzlich möglichen Sekunden sind Schaltsekunden)
tm_isdst ist positiv, wenn Sommerzeit gilt, Null, wenn Sommerzeit nicht gilt, und negativ, wenn
die Information nicht zur Verfügung steht.
clock_t clock(void)
clock liefert die Rechnerkern-Zeit, die das Programm seit Beginn seiner
Ausführung verbraucht hat, oder -1, wenn diese Information nicht zur Verfügung
steht. clock()/CLOCKS_PER_SEC ist eine Zeit in Sekunden.
time_t time(time_t *tp)
time liefert die aktuelle Kalenderzeit oder -1, wenn diese nicht zur Verfügung
steht. Wenn tp von NULL verschieden ist, wird der Resultatwert auch
bei *tp abgelegt.
double difftime(time_t time2, time_t timel)
difftime liefert time2 - timel ausgedrückt in Sekunden.
time_t mktime(struct tm *tp)
mktime wandelt die Ortszeit in der Struktur *tp in Kalenderzeit um, die so
dargestellt wird wie bei time. Die Komponenten erhalten Werte in den angegebenen
Bereichen. mktime liefert die Kalenderzeit oder -1, wenn sie
nicht dargestellt werden kann.
Die folgenden vier Funktionen liefern Zeiger auf statische Objekte, die von anderen Aufrufen überschrieben
werden können.
char *asctime(const struct tm *tp)
char *ctime(const time_t *tp)
struct tm *gmtime(const time_t *tp)
struct tm *localtime(const time_t *tp)
asctime konstruiert aus der Zeit in der Struktur *tp eine Zeichenkette der
Form
Sun Jan 3 15:14:13 1988\n\0
ctime verwandelt die Kalenderzeit *tp in Ortszeit; dies ist äquivalent zu
asctime(localtime(tp))
gmtime verwandelt die Kalenderzeit *tp in Coordinated Universal Time
(UTC). Die Funktion liefert NULL, wenn UTC nicht zur Verfügung steht.
Der Name gmtime hat historische Bedeutung.
localtime verwandelt die Kalenderzeit *tp in Ortszeit.
Gedruckt am 10.09.2009 14:23:00 Letzte Änderung am: 10. September 2009 Version 2.4.1, I. Oesch 72/147