.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:49:27 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Fri Apr 26 12:38:55 MET DST 1996 by Martin Schulze .\" Translated to German Tue Dec 31 1996 by Patrick Rother .\" .TH CTIME 3 "31. Dezember 1996" "BSD" "Bibliotheksfunktionen" .SH BEZEICHNUNG asctime, ctime, gmtime, localtime, mktime \- wandle binäres Datum und Uhrzeit nach ASCII .SH ÜBERSICHT .nf .B #include .sp .BI "char *asctime(const struct tm *" timeptr ); .sp .BI "char *ctime(const time_t *" timep ); .sp .BI "struct tm *gmtime(const time_t *" timep ); .sp .BI "struct tm *localtime(const time_t *" timep ); .sp .BI "time_t mktime(struct tm *" timeptr ); .sp .BI "extern char *" tzname [2]; .BI "long int " timezone ; .BI "extern int " daylight ; .fi .SH BESCHREIBUNG Die Funktionen \fBctime()\fP, \fBgmtime()\fP und \fBlocaltime()\fP benötigen ein Argument des Datentyps \fItime_t\fP, welches die Calendar-Zeit darstellt. Bei Interpretation als absolute Zeit stellt sie die Anzahl der Sekunden dar, die seit dem 1. Januar 1970, 00:00.00 Uhr Universalzeit (UTC) verstrichen sind. .PP Die Funktionen \fBasctime()\fP und \fBmktime()\fP benötigen beide ein Argument das eine aufgeteilte Zeitangabe darstellt, d.h. eine binäre Darstellung, die in Jahr, Monat, Tag usw. aufgeteilt ist. Diese Angaben sind in einer Struktur \fItm\fP gespeichert, die in \fI\fP wie folgt definiert ist: .sp .RS .nf .ne 12 .ta 8n 16n 32n struct tm { int tm_sec; /* Sekunden */ int tm_min; /* Minuten */ int tm_hour; /* Stunden */ int tm_mday; /* Monatstag */ int tm_mon; /* Monat */ int tm_year; /* Jahr */ int tm_wday; /* Wochentag */ int tm_yday; /* Jahrestag */ int tm_isdst; /* Sommerzeit */ }; .ta .fi .RE .PP Die Elemente der Struktur \fItm\fP sind: .TP .I tm_sec Die Anzahl der Sekunden nach der vollen Minute, normalerweise im Bereich 0 bis 59, jedoch in Ausnahmefällen bis 61 um Schaltsekunden zu erlauben. .TP .I tm_min Die Anzahl der Minuten nach der vollen Stunde, im Bereich 0 bis 59. .TP .I tm_hour Die Anzahl der Stunden nach Mitternacht, im Bereich 0 bis 23. .TP .I tm_mday Der Tag im Monat, im Bereich 1 bis 31. .TP .I tm_mon Die Anzahl der Monate seit Januar, im Bereich 0 bis 11. .TP .I tm_year Die Anzahl der Jahre nach 1900. .TP .I tm_wday Die Anzahl der Tag seit Sonntag, im Bereich 0 bis 6. .TP .I tm_yday Die Anzahl der Tage seit dem 1. Januar, im Bereich 0 bis 365. .TP .I tm_isdst Ein Flag das anzeigt ob Sommerzeit herrscht für die angegebene Zeit. Der Wert ist positiv wenn Sommerzeit herrscht, Null wenn nicht, und negativ wenn die Information nicht verfügbar ist. .PP Die Funktion \fBctime()\fP wandelt die Calendar-Zeit \fItimep\fP in einen String der Form .sp .RS "Wed Jun 30 21:49:08 1993\\n" .RE .sp Die Abkürzungen für die Wochentage sind `Sun', `Mon', `Tue', `Wed', `Thu', `Fri', und `Sat'. Die Abkürzungen für die Monate sind `Jan', `Feb', `Mar', `Apr', `May', `Jun', `Jul', `Aug', `Sep', `Oct', `Nov', und `Dec'. Der Rückgabewert zeigt auf einen statisch belegten String welcher durch nachfolgende Aufrufe von Datums-/Uhrzeitfunktionen überschrieben werden darf. Die Funktion setzt auch die externe Variable \fItzname\fP mit Informationen über die aktuelle Zeitzone. .PP Die Funktion \fBgmtime()\fP wandelt die Calendar-Zeit \fItimep\fP in eine aufgeteilte Zeitangabe, ausgedrückt in Universalzeit (UTC). .PP Die Funktion \fBlocaltime()\fP wandelt die Calendar-Zeit \fItimep\fP in eine aufgeteilte Zeitangabe, ausgedrückt relativ zu der Benutzerspezifizierten Zeitzone. Die Funktion setzt auch die externe Variable \fItzname\fP mit Informationen über die aktuelle Zeitzone, \fItimezone\fP mit der Differenz zwischen Universalzeit (UTC) und der lokalen Standardzeit in Sekunden, sowie \fIdaylight\fP auf einen Nicht-Null-Wert wenn Standard-US-Sommerzeitregeln greifen. .PP Die Funktion \fBasctime()\fP wandelt die aufgeteilte Zeitangabe \fItimeptr\fP in einen String mit dem gleichen Format wie \fBctime()\fP. Der Rückgabewert zeigt auf einen statisch belegten String welcher durch nachfolgende Aufrufe von Datums-/Uhrzeitfunktionen überschrieben werden darf. .PP Die Funktion \fBmktime()\fP wandelt die aufgeteilte Zeitangabe, ausgedrückt als lokale Zeit, in Calendar-Zeit. Die Funktion ignoriert die Inhalte der Strukturelemente \fItm_wday\fP und \fItm_yday\fP und berechnet sie neu aus den anderen Informationen der Struktur für die aufgeteilte Zeitangabe. Aufrufen von \fBmktime()\fP setzt auch die externe Variable \fItzname\fP mit Informationen über die aktuelle Zeitzone. Wenn die angegebene aufgeteilte Zeitangabe nicht als Calendar-Zeit dargestellt werden kann gibt \fBmktime()\fP den Wert (time_t)(\-1) zurück und verändert die Elemente \fItm_wday\fP und \fItm_yday\fP der aufgeteilten Zeitangabe nicht. .SH "KONFORM ZU" SVID 3, POSIX, BSD 4.3, ISO 9899 .SH "SIEHE AUCH" .BR date (1), .BR gettimeofday (2), .BR time (2), .BR tzset (3), .BR difftime (3), .BR strftime (3), .BR newctime (3).