asctime - Datum mit Uhrzeit in englischer Darstellung

Definition

#include <time.h>

char *asctime(const struct tm *tm_zg);

asctime wandelt eine gemäß der Struktur tm (s.u.) aufgeschlüsselte Zeitangabe in eine
Zeichenkette um. Dabei wird nicht überprüft, ob es sich um eine sinnvolle Zeitangabe
handelt, d.h. ob z.B. die angegebene Tageszahl zum angegebenen Monat passt. Ein Fehler
liegt nur dann vor, wenn sich die eingegebenen Daten nicht im Zielformat darstellen lassen.
So sind z.B. die kleinste darstellbare Jahreszahl -999 und die größte darstellbare Jahreszahl
9999.

Parameter

const struct tm *tm_zg Struktur gemäß der include-Datei <time.h>:

struct tm
{
       int   tm_sec;        /* Sekunden (0-59) */
       int   tm_min;        /* Minuten (0-59) */
       int   tm_hour;       /* Stunden (0-23) */
       int   tm_mday;       /* Tag des Monats (1-31) */
       int   tm_mon;        /* Monate ab Jahresbeginn (0-11) */
       int   tm_year;       /* Jahre seit 1900 */
       int   tm_wday;       /* Wochentag (0-6, Sonntag=0) */
       int   tm_yday;       /* Tage seit dem 1. Januar (0-365) */
       int   tm_isdst;      /* Sommerzeitanzeige */
};

Returnwert

Zeiger auf die erzeugte Zeichenkette
	Die Ergebniszeichenkette hat die Länge 26 (einschließlich des abschließenden Null-bytes \0) und das Format einer Datumsangabe mit Uhrzeit in Englisch: Wochentag Monat Tag Std:Min:Sek Jahr, z.B. Fri Apr 29 12:01:20 2011\n\0
NULL	im Fehlerfall

Hinweise

Die Funktionen asctime, ctime, ctime64, gmtime, gmtime64, localtime und localtime64 schreiben ihre Ergebnisse in denselben C-internen Datenbereich, so dass der Aufruf einer dieser Funktionen das vorherige Ergebnis einer der anderen Funktionen überschreibt.

Eine Struktur vom Typ tm wird von den Funktionen gmtime, gmtime64, localtime und localtime64 geliefert.

Die Aufrufe asctime(localtime(sek_zg)) und ctime(sek_zg) sind äquivalent. Ebenso
sind die Aufrufe asctime(localtime64(sek_zg)) und ctime64(sek_zg) äquivalent.

Beispiel

Ausgabe der aktuellen Zeit

#include <time.h>
#include <stdio.h>
struct tm *t;
char *s;
time_t clk;
int main(void)
{
   clk = time((time_t *) 0);
   t = gmtime(&clk);
   printf("Jahr: %d\n", t->tm_year + 1900);
   printf("Uhrzeit in Stunden: %d\n", t->tm_hour);
   printf("Jahrestag: %d\n", t->tm_yday);
   s = asctime(t);
   printf("%s", s);
   return 0;
}

 Siehe auch

ctime, ctime64, gmtime, gmtime64, localtime, localtime64, mktime, mktime64, time, time64