asctime

Nach oben zu time.h - Index

Header-Datei

time.h

Kategorie

Uhrzeit- und Datumsroutinen

Prototyp

char *asctime(const struct tm *tblock);

wchar_t *_wasctime(const struct tm *tblock);

Beschreibung

asctime konvertiert Datum und Zeit in einen ASCII-String.

_wasctime konvertiert Datum und Zeit in einen String des Typs wchar_t.

asctime und _wasctime konvertieren in einer Struktur gespeicherte Datums- und Zeitwerte in einem 26 Zeichen langen Einzelbyte- oder Multibyte-String der folgenden Form:

Mon Nov 21 11:31:54 1983\n\0

Alle Felder haben eine konstante Breite. Die ausgegebenen Strings für Wochentag und Monat entsprechen Folgendem:

tm-Parameter Gültiger Bereichswert Ausgabe

tm.mon (Monat) 0-11 0=Jan, 1=Feb usw.

tm.day (Wochentag) 0-6 0=Sun, 1=Mon usw.

Rückgabewert

asctime und _wasctime geben einen Zeiger auf den jeweiligen, Datum und Zeit enthaltenden String zurück. Dieser String ist statisch und wird bei jedem weiteren Aufruf überschrieben. asctime konvertiert die in der Struktur *tblock gespeicherten Datums- und Zeitangaben in einen 26 Zeichen langen String der gleichen Form wie der ctime-String:

Sun Sep 16 01:03:52 1973\n\0

Beispiel

 #include <string.h>
 #include <time.h>
 #include <stdio.h>
 int main(void)
 {
   struct tm t;
   char str[80];
   /* Beispielbelegung einer tm-Struktur  */
   t.tm_sec    = 1;  /* Sekunden */
   t.tm_min    = 30; /* Minuten */
   t.tm_hour   = 9;  /* Stunden */
   t.tm_mday   = 22; /* Tag des Monats  */
   t.tm_mon    = 11; /* Monat */
   t.tm_year   = 56; /* Jahr - ohne Jahrhundertangabe */
   t.tm_wday   = 4;  /* Wochentag  */
   t.tm_yday   = 0;  /* Wird von asctime nicht ausgewertet */
   t.tm_isdst  = 0;  /* Sommerzeit; wird von asctime nicht ausgewertet */
   /* Struktur in einen nullterminierten String konvertieren */
   strcpy(str, asctime(&t));
   printf("%s\n", str);
   return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
asctime	+	+	+	+
_wasctime		+