ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Artikel
02/26/2013

Konvertiert einen Zeitwert in eine Zeichenfolge und erstellen auf Einstellungen der lokalen Zeitzone ein.Sicherere Versionen dieser Funktionen sind verfügbar. Weitere Informationen finden Sie unter ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s.

char *ctime( 
   const time_t *timer 
);
char *_ctime32( 
   const __time32_t *timer )
;
char *_ctime64( 
   const __time64_t *timer )
;
wchar_t *_wctime( 
   const time_t *timer 
);
wchar_t *_wctime32( 
   const __time32_t *timer
);
wchar_t *_wctime64( 
   const __time64_t *timer 
);

Parameter

timer
Zeiger auf gespeicherten Zeit.

Rückgabewert

Ein Zeiger auf das Ergebnis der Zeichenfolgen.NULL wird zurückgegeben, wenn:

time stellt ein Datum vor Mitternacht UTC am 1. Januar 1970 dar.
Wenn Sie verwenden, stellt _ctime32 oder _wctime32 und time ein Datum nach 03:14 an: Am 7. Januar 19 2038.
Wenn Sie verwenden, stellt _ctime64 oder _wctime64 und time ein Datum nach 23:59 an: 59 3000 am 31. Dezember, UTC.

ctime ist eine Inlinefunktion, die _ctime64auswertet und time_tzu __time64_tentspricht.Wenn Sie den Compiler erzwingen müssen, um alte als time_t32-Bit- time_tinterpretiert wird, können Sie _USE_32BIT_TIME_Tdefinieren.Auf diese Weise wird ctime, _ctime32auszuwerten.Dies wird nicht empfohlen, da die Anwendung möglicherweise nach dem 18. Januar 2038 fehlschlägt, und sie wird nicht auf 64-Bit-Plattformen nicht zulässig.

Hinweise

Die ctime-Funktion konvertiert einen Uhrzeitwert, der als time_t-Wert in eine Zeichenfolge gespeichert wird.Der timer-Wert wird normalerweise bei einem Aufruf von Zeitabgerufen, der die Anzahl der Sekunden verstrich seit Mitternacht (00:00: Zurückgebenam 1. Januar 1970 00) koordinierte Weltzeit (UTC).Der Rückgabewert enthält die Zeichenfolge genau 26 Zeichen und besitzt das Format:

Wed Jan 02 02:03:55 1980\n\0

Ein 24-Stunden-Format wird verwendet.Alle Felder verfügen über eine konstante Breite.Das Zeilenumbruchzeichen („\ n ") und das NULL-Zeichen („\ 0 ") die letzten beiden Positionen der Zeichenfolge ein.

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

Ein Aufruf von ctime ändert den einzelnen statisch verknüpften Puffer, der von der gmtime und localtime-Funktionen verwendet wird.Jeder Aufruf von einer der folgenden Routinen zerstört das Ergebnis des vorherigen Aufrufs.ctime gibt einen statischen Puffers mit der asctime-Funktion frei.Auf diese Weise zerstört ein Aufruf ctime die Ergebnisse jedes früheren Aufruf von asctime, localtimeoder gmtime.

_wctime und _wctime64 sind die Breitzeichen-Version von ctime und _ctime64. einen Zeiger auf eine Zeichenfolge mit Breitzeichen zurückgeben.Andernfalls verhalten sich _ctime64, _wctimeund _wctime64 identisch mit ctime.

Diese Funktionen überprüfen deren Parameter.Wenn timer ein NULL-Zeiger ist, oder wenn der Zeitgeber dem Wert negativ ist, rufen diese Funktionen der ungültige Parameter für ein, wie in Parametervalidierungbeschrieben.Wenn die Ausführung fortgesetzt werden kann, darf die Funktionen geben NULL festlegen und errno zu EINVAL.

Zuweisung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert	_MBCS definieren	_UNICODE definiert
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Anforderungen

Routine	Erforderlicher Header
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> oder <wchar.h>
_wctime32	<time.h> oder <wchar.h>
_wctime64	<time.h> oder <wchar.h>

Um Kompatibilität zusätzlichen Informationen finden Sie unter Kompatibilität in der Einführung.

Beispiel

// crt_ctime64.c
// compile with: /W3
/* This program gets the current
 * time in _time64_t form, then uses ctime to
 * display the time in string form.
 */

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

int main( void )
{
   __time64_t ltime;

   _time64( &ltime );
   printf( "The time is %s\n", _ctime64( &ltime ) ); // C4996
   // Note: _ctime64 is deprecated; consider using _ctime64_s
}