asctime, _wasctime

Artikel
02/26/2013

Konvertieren einer tm Zeit Struktur in eine Zeichenfolge.Sicherere Versionen dieser Funktionen sind verfügbar. Weitere Informationen 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

Zeichenfolgenasctime gibt einen Zeiger auf das Ergebnis zurück. _wasctime gibt einen Zeiger auf den Zeichenfolge mit Breitzeichenen-Ergebnis zurück.Es gibt keinen Rückgabewert des Fehlers.

Hinweise

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

Die asctime-Funktion konvertiert eine Uhrzeit, die als Struktur in eine Zeichenfolge gespeichert wird.Der timeptr-Wert wird normalerweise bei einem Aufruf von gmtime oder localtime, die beide ein Zeiger auf eine Struktur tm zurückgeben, definiert in TIME.H. abgerufen.

timeptr Member	Wert
tm_hour	seit Mitternacht vergangenen Stunden (0-23)
tm_isdst	positiv, wenn die Sommerzeit aktiv ist. 0 = Sommerzeit nicht aktiv ist. negativ, wenn Status der Sommerzeit unbekannt ist.Die C-Laufzeitbibliothek weist die der Vereinigten Staaten Regeln zum Implementieren der Berechnung der Sommerzeit an (DST).
tm_mday	Tag des Monats (1-31)
tm_min	Minuten nach der vollen Stunde (0-59)
tm_mon	Monat (0-11. Januar = 0)
tm_sec	Sekunden nach Minute (0-59)
tm_wday	Tag der Woche (0-6. 0 = Sonntag
tm_yday	Tag des Jahres (0-365. Am 1. Januar = 0)
tm_year	Jahres (laufendes Jahr minus 1900)

Die konvertierte Zeichenfolge wird ebenfalls entsprechend den Einstellungen der lokalen Zeitzone passt.Informationen zum Konfigurieren der Ortszeit finden Sie unter Zeit, _ftimeund localtime-Funktionen und die Funktion _tzset Informationen zum Definieren der Zeitzonen Umgebungen und der globalen Variablen.

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

_wasctime ist eine Breitzeichen-Version von asctime._wasctime und asctime verhalten sich ansonsten unterscheiden.

Diese Funktionen überprüfen deren Parameter.Wenn timeptr ein NULL-Zeiger ist, oder wenn er Werte außerhalb des Gültigkeitsbereichs ungültige Parameter enthält, wird der Ereignishandler aufgerufen, wie in Parametervalidierungbeschrieben.Wenn die Ausführung ermöglicht wird, um fortzufahren, gibt die Funktion NULL zurück und legt ihn fest. EINVALzu errno

Zuweisung generischer Textroutinen

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

Anforderungen

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

Beispiel

Dieses Programm wird die Systemzeit in langen ganzzahligen aclock, übersetzt sie in die Struktur newtime und konvertiert sie anschließend in die Zeichenfolgenform für die Ausgabe 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
}