Home » Linux Manpages » asctime
Man(1) output converted with man2html
[ Print ]
asctime
Linux Manpage
ÜBERSICHT
#include <time.h>
char *asctime(const struct tm *timeptr);
char *ctime(const time_t *timep);
struct tm *gmtime(const time_t *timep);
struct tm *localtime(const time_t *timep);
time_t mktime(struct tm *timeptr);
extern char *tzname[2];
long int timezone;
extern int daylight;
BESCHREIBUNG
Die Funktionen ctime(), gmtime() und localtime() benötigen ein Argument
des Datentyps time_t, welches die Calendar-Zeit darstellt. Bei Inter-
pretation als absolute Zeit stellt sie die Anzahl der Sekunden dar, die
seit dem 1. Januar 1970, 00:00.00 Uhr Universalzeit (UTC) verstrichen
sind.
Die Funktionen asctime() und mktime() 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 tm gespeichert, die in <time.h> wie folgt definiert ist:
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 */
};
Die Elemente der Struktur tm sind:
tm_sec Die Anzahl der Sekunden nach der vollen Minute, normalerweise im
Bereich 0 bis 59, jedoch in Ausnahmefällen bis 61 um Schalt-
sekunden zu erlauben.
tm_min Die Anzahl der Minuten nach der vollen Stunde, im Bereich 0 bis
59.
tm_yday
Die Anzahl der Tage seit dem 1. Januar, im Bereich 0 bis 365.
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.
Die Funktion ctime() wandelt die Calendar-Zeit timep in einen String
der Form
"Wed Jun 30 21:49:08 1993
"
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 Vari-
able tzname mit Informationen über die aktuelle Zeitzone.
Die Funktion gmtime() wandelt die Calendar-Zeit timep in eine
aufgeteilte Zeitangabe, ausgedrückt in Universalzeit (UTC).
Die Funktion localtime() wandelt die Calendar-Zeit timep in eine
aufgeteilte Zeitangabe, ausgedrückt relativ zu der Benutzerspezi-
fizierten Zeitzone. Die Funktion setzt auch die externe Variable
tzname mit Informationen über die aktuelle Zeitzone, timezone mit der
Differenz zwischen Universalzeit (UTC) und der lokalen Standardzeit in
Sekunden, sowie daylight auf einen Nicht-Null-Wert wenn Standard-US-
Sommerzeitregeln greifen.
Die Funktion asctime() wandelt die aufgeteilte Zeitangabe timeptr in
einen String mit dem gleichen Format wie ctime(). Der Rückgabewert
zeigt auf einen statisch belegten String welcher durch nachfolgende
Aufrufe von Datums-/Uhrzeitfunktionen überschrieben werden darf.
Die Funktion mktime() wandelt die aufgeteilte Zeitangabe, ausgedrückt
als lokale Zeit, in Calendar-Zeit. Die Funktion ignoriert die Inhalte
der Strukturelemente tm_wday und tm_yday und berechnet sie neu aus den
anderen Informationen der Struktur für die aufgeteilte Zeitangabe.
Aufrufen von mktime() setzt auch die externe Variable tzname mit Infor-
mationen über die aktuelle Zeitzone. Wenn die angegebene aufgeteilte
Zeitangabe nicht als Calendar-Zeit dargestellt werden kann gibt
mktime() den Wert (time_t)(-1) zurück und verändert die Elemente
tm_wday und tm_yday der aufgeteilten Zeitangabe nicht.
KONFORM ZU
SVID 3, POSIX, BSD 4.3, ISO 9899
SIEHE AUCH
date(1), gettimeofday(2), time(2), tzset(3), difftime(3), strftime(3),
Man(1) output converted with man2html
Tag Clouds
beschreibung
Übersicht
#include < absolute anzahl argument
asctime benötigen calendar-zeit char const ctime dar darstellt datentyps daylight die
extern funktionen gmtime h> int inter-
januar linux localtime long manpage mktime pretation sekunden stellt struct time time_t timep timeptr timezone tzname zeit
Social-Bookmark
Update: 23.01.2012 13:03
