Es wird empfohlen, Visual Studio 2017 zu verwenden

ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

 

Veröffentlicht: Oktober 2016

Die neueste Dokumentation zu Visual Studio 2017 finden Sie unter Dokumentation zu Visual Studio 2017.

Konvertieren Sie einen Zeitwert in eine Zeichenfolge, und passen Sie für die lokale Zeit Einstellungen. Sicherere Versionen dieser Funktionen sind verfügbar. 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
Ein Zeiger auf die gespeicherte Zeit.

Ein Zeiger auf das Ergebnis die Zeichen der Zeichenfolge. NULLWenn zurückgegeben:

  • timeein Datum vor Mitternacht, 1. Januar 1970 UTC darstellt.

  • Bei Verwendung von _ctime32 oder _wctime32 und time ein Datum nach 23:59:59 am 18. Januar 2038 UTC darstellt.

  • Bei Verwendung von _ctime64 oder _wctime64 und time ein Datum nach 23:59:59, 31. Dezember 3000 UTC darstellt.

ctimeist eine Inlinefunktion bewertet, um _ctime64 und time_t entspricht __time64_t. Möchten Sie den Compiler, interpretieren erzwingen time_t als das alte 32-Bit time_t, können _USE_32BIT_TIME_T. Dadurch wird ctime ergibt _ctime32. Dies wird nicht empfohlen, da die Anwendung nach dem 18. Januar 2038 fehlschlägt und sie wird auf 64-Bit-Plattformen nicht zugelassen.

Die ctime -Funktion konvertiert einen Zeitwert als ein Time_t Wert in eine Zeichenfolge. Die timer Wert wird normalerweise von einem Aufruf abgerufen Zeit, welche gibt die Anzahl der Sekunden seit Mitternacht vergangenen (00: 00:00), 1. Januar 1970, koordinierte Weltzeit (UTC). Die Rückgabewert Zeichenfolge genau 26 Zeichen enthält und weist folgende Form:

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

24-Stunden-Format wird verwendet. Alle Felder weisen eine Konstante Breite. Das Zeilenumbruchzeichen ('\n') und das Null-Zeichen ('\0') belegen die letzten beiden Stellen der Zeichenfolge.

Die konvertierte Zeichenfolge wird auch die Ortszeit Einstellungen angepasst. Finden Sie unter der time, _ftime, und Localtime Funktionen Informationen zum Konfigurieren der lokalen Zeit und die _tzset Funktion ausführliche Informationen zum Definieren der Zeitzone Umgebung und globale Variablen.

Ein Aufruf von ctime ändert der einzelnen statisch zugewiesenen Puffer für die gmtime und localtime Funktionen. Jeder Aufruf dieser Routinen zerstört das Ergebnis des vorherigen Aufrufs. ctimeTeilt einen statischen Puffer mit der asctime Funktion. Folglich einen Aufruf von ctime löscht die Ergebnisse von einem vorherigen Aufruf von asctime, localtime, oder gmtime.

_wctimeund _wctime64 sind die Breitzeichen-Version der ctime und _ctime64; die Rückgabe eines Zeigers auf Breitzeichen-Zeichenfolge. Andernfalls _ctime64, _wctime, und _wctime64 Verhalten sich genauso wie ctime.

Diese Funktionen überprüfen ihre Parameter. Wenn timer ein null-Zeiger ist oder wenn der Zeitwert negativ ist, rufen diese Funktionen den Handler für ungültige Parameter an, wie in beschrieben Parametervalidierung. Wenn die weitere Ausführung zugelassen wird, gibt diese Funktion NULL zurück und setzt errno auf EINVAL.

Zuordnung generischer Textroutinen

TCHAR.H-Routine_UNICODE und _MBCS nicht definiert._MBCS definiert_UNICODE definiert
_tctimectimectime_wctime
_tctime32_ctime32_ctime32_wctime32
_tctime64_ctime64_ctime64_wctime64
RoutineErforderlicher Header
ctime<time.h>
_ctime32<time.h>
_ctime64<time.h>
_wctime<time.h>oder<wchar.h></wchar.h></time.h>
_wctime32<time.h>oder<wchar.h></wchar.h></time.h>
_wctime64<time.h>oder<wchar.h></wchar.h></time.h>

Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

// 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  
}  

The time is Wed Feb 13 16:04:43 2002  

Benötigte Zeit
Asctime _wasctime
Ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s
_ftime, _ftime32, _ftime64
Gmtime, _gmtime32, _gmtime64
LocalTime, _localtime32, _localtime64
Zeit, _time32, _time64

Anzeigen: