====== asctime() ======

asctime ist definiert in der ''[[start|time]]'', die in C über ''time.h'', bzw. in C++ über ''ctime'' eingebunden wird.

===== Funktion =====
Übersetzt eine [[struct_tm|tm-Struktur]] in einen menschenlesbaren C-String (inkl. Nullbyte) in folgemdem Format: \\
Www Mmm dd hh:mm:ss yyyy

**Www**: Wochentag (z.B. Mon)\\
**Mmm**: Monat (z.B. Feb)\\
**tt**: Tag des Monats (z.B. 5)\\
**hh**: aktuelle Stunde\\
**mm**: aktuelle Minute\\
**ss**: aktuelle Sekunde\\
**jjjj**: aktuelles Jahr

===== Signatur =====
<code cpp>
#include <time.h>
char * asctime ( const struct tm * timePtr );</code>

**timePtr**: Zu übersetzende [[struct_tm|tm-Struktur]]

**Return value**: Zeiger auf einen Buffer, der den String enthält.

===== Fehlerquellen =====

Der String, der das Datum enthält ist, ist statisch für die Funktionen [[ctime|ctime()]] und asctime() vorgesehen. Sobald eine der Funktionen aufgerufen wird, wird der String überschrieben.
Im Zweifelsfall sollte der Inhalt kopiert werden.

===== Beispiel =====

<code cpp>
#include <stdio.h>
#include <time.h>
#include <stdlib.h>

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;

  time ( &rawtime );
  timeinfo = localtime ( &rawtime );
  printf ( "Das aktuelle Datum lautet: %s", asctime (timeinfo) );

  return EXIT_SUCCESS;
}
</code>

Ausgabe:
<code>Das aktuelle Datum lautet: Thu Mar 26 06:00:48 2009</code>

===== siehe auch =====

[[c:lib:time:start|time]]: [[c:lib:time:time|time()]], [[c:lib:time:time_t|time_t]], [[c:lib:time:ctime|ctime()]], [[c:lib:time:strftime|strftime()]]