asctime, _wasctime

Artikel
06/09/2015

Konvertiert eine Zeitstruktur tm in eine Zeichenfolge. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter asctime_s, _wasctime_s.

char *asctime( 
   const struct tm *timeptr 
);
wchar_t *_wasctime( 
   const struct tm *timeptr 
);

Parameter

timeptr
Datum-/Uhrzeit-Struktur.

Rückgabewert

asctime gibt einen Zeiger auf Zeichenfolgenergebnis zurück; _wasctime gibt einen Zeiger z Zeichenfolge mit Breitzeichenen-Ergebnis zurück. Es gibt keinen Fehlerrückgabewert.

Hinweise

Sicherere Versionen dieser Funktionen sind verfügbar; finden Sie unter asctime_s, _wasctime_s.

Die asctime-Funktion konvertiert eine Zeit, die als Struktur einer Zeichenfolge gespeichert ist. Der Wert timeptr wird normalerweise von einem Aufruf von gmtime oder localtime, die beide einen Zeiger auf eine Struktur tm zurückgeben, die in TIME.H. erhalten.

timeptr Member	Wert
tm_hour	Stunden ab Mitternacht (0-23)
tm_isdst	Positiv, wenn Sommerzeit wirksam ist; 0 die Sommerzeit nicht aktiv ist; Negativ, wenn Status der Sommerzeit nicht bekannt ist. Die C-Laufzeitbibliothek die akzeptiert der Vereinigten Staaten Regeln zum Implementieren der Berechnung der Sommerzeit (DST) an.
tm_mday	Tag des Monats (1-31)
tm_min	Minuten nach Stunde (0-59)
tm_mon	Monat (0-11; Januar = 0)
tm_sec	Sekunden nach Minute (0-59)
tm_wday	Wochentag (0-6; Sonntag = 0)
tm_yday	Tag des Jahres (0-365; Am 1. Januar = 0)
tm_year	Jahr (Open-Wheel-Racing-Team Jahr minus 1900)

Die konvertierte Zeichenfolge wird auch nach den Einstellungen der lokalen Zeitzone angepasst. Informationen zum Konfigurieren der Ortszeit, finden Sie unter time, _ftime und localtime-Funktionen und die _tzset-Funktion zu Informationen über das Definieren der Zeitzonenumgebung und der globalen Variablen.

Das Zeichenfolgenergebnis, das von asctime erzeugt wird, enthält genau 26 Zeichen und weist das Format Wed Jan 02 02:03:55 1980\n\0. Ein 24-Stunden-Format wird verwendet. Alle Felder verfügen eine konstante Breite. Das Zeilenumbruchzeichen und das Nullzeichen nehmen die letzten zwei Positionen der Zeichenfolge ein. asctime verwendet einen einzelnen, statisch zugehörigen Puffer, um die Rückgabezeichenfolge aufzunehmen. Jeder Aufruf dieser Funktion zerstört das Ergebnis der vorherigen Aufrufs.

_wasctime ist eine Breitzeichenversion von asctime. _wasctime und asctime verhalten sich andernfalls identisch.

Diese Funktionen überprüfen ihre Parameter. Wenn timeptr ein NULL-Zeiger ist oder wenn er außerhalb des Gültigkeitsbereichs liegenden Werte enthält, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, gibt die Funktion NULL zurück und setzt errno auf EINVAL.

Zuordnung generische Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tasctime	asctime	asctime	_wasctime

Anforderungen

Routine	Erforderlicher Header
asctime	<time.h>
_wasctime	<time.h oder> wchar.h <>

Beispiel

Dieses Programm platziert die Systemzeit in langen ganzzahligen aclock, übersetzt sie in die newtime-Struktur und konvertiert sie anschließend in Zeichenfolgenform für Ausgaben, mit der asctime-Funktion.

// crt_asctime.c
// compile with: /W3

#include <time.h>
#include <stdio.h>

int main( void )
{
    struct tm   *newTime;
    time_t      szClock;

    // Get time in seconds
    time( &szClock );

    // Convert time to struct tm form 
    newTime = localtime( &szClock );

    // Print local time as a string.
    printf_s( "Current date and time: %s", asctime( newTime ) ); // C4996
    // Note: asctime is deprecated; consider using asctime_s instead
}