Exportieren (0) Drucken
Alle erweitern
and
Uhr
div
eof
not
or
xor
Erweitern Minimieren
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Konvertiert einen Zeitwert in eine Zeichenfolge und berücksichtigt die Einstellungen der lokalen Zeitzone. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu 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 
);

timer

Zeiger auf die gespeicherte Zeit.

Ein Zeiger auf Zeichenfolgenergebnis. NULL wird zurückgegeben, wenn:

  • time ein Datum vor Mitternacht UTC des 1. Januar 1970 darstellt.

  • Wenn Sie _ctime32 oder _wctime32 benutzen und time ein Datum nach 03:14 :07 Uhr des 19. Januar 2038 darstellt.

  • Wenn Sie _ctime64 oder _wctime64 verwenden und time ein Datum nach 23:59:59 Uhr des 31. Dezember UTC darstellt.

ctime ist eine Inlinefunktion, die _ctime64 als Ergebnis liefert, und time_t ist äquivalent zu __time64_t. Wenn Sie den Compiler zwingen müssen, time_t als altes 32-Bit-time_t zu interpretieren, können Sie _USE_32BIT_TIME_T definieren. Hierdurch wird ctime , _ctime32 auszuwerten. Dies wird nicht empfohlen, da die Anwendung möglicherweise nach dem 18. Januar 2038 fehlschlägt, und es auf 64-Bit-Plattformen nicht zulässig ist.

Die ctime-Funktion konvertiert einen Uhrzeit, die als time_t-Wert gespeichert ist, in eine Zeichenfolge. Der timer-Wert wird normalerweise bei einem Aufruf von Zeit abgerufen, der die Anzahl der Sekunden seit Mitternacht (00:00) des 1. Januar 1970 nach koordinierter Weltzeit (UTC) zurückgibt.. Der zurückgegebene Zeichenfolge enthält genau 26 Zeichen und besitzt das Format:

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

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

Die konvertierte Zeichenfolge wird außerdem entsprechend der lokalen Zeitzoneneinstellung anpasst. Weitere Informationen zum Konfigurieren der lokale Zeit finden Sie unter time, _ftime und localtime-Funktionen. Informationen zum Definieren der Zeitzonenumgebungen und der globalen Variablen finden Sie bei der Funktion _tzset .

Ein Aufruf von ctime ändert den einzelnen zugeordneten statisch Puffer, der von der gmtime und localtime-Funktionen verwendet wird. Jeder Aufruf bis eine dieser Routinen zerstört das Ergebnis der vorherigen Aufrufs. ctime teilt sich einen statischen Puffers mit der asctime-Funktion. Auf diese Weise zerstört ein Aufruf ctime die Ergebnisse jedes früheren Aufruf von asctime, localtime oder gmtime.

_wctime und _wctime64 sind die Breitzeichen-Versionen von ctime und _ctime64. Sie geben einen Zeiger auf eine Zeichenfolge mit Breitzeichen zurück. Ansonsten verhalten sich _ctime64, _wctime und _wctime64 identisch zu ctime.

Diese Funktionen überprüfen ihre Parameter. Wenn timer ein NULL-Zeiger ist oder wenn der timer-Wert negativ ist, rufen diese Funktionen den Handler für ungültige Parameter auf, wie in Parametervalidierung beschrieben. Wenn die Ausführung fortgesetzt werden darf, geben die Funktionen NULL zurück und setzen errno auf EINVAL.

Zuordnung generischer Textroutinen

TCHAR.H-Routine

_UNICODE & _MBCS nicht definiert

_MBCS definiert

_UNICODE definiert

_tctime

ctime

ctime

_wctime

_tctime32

_ctime32

_ctime32

_wctime32

_tctime64

_ctime64

_ctime64

_wctime64

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

Weitere 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

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft