ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Articolo
03/26/2013

Convertire un valore in una stringa e registrare per ottenere le impostazioni del fuso orario locale.Più versioni sicure di queste funzioni sono disponibili, vedere 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 
);

Parametri

timer
puntatore a tempo archiviato.

Valore restituito

Un puntatore al risultato della stringa di caratteri.NULL verrà restituito se:

time rappresenta una data prima di mezzanotte, il 1° gennaio 1970, UTC.
Se si utilizzano _ctime32 o _wctime32 e time rappresenta una data dopo il 03:14: 7 gennaio 19, 2038.
Se si utilizzano _ctime64 o _wctime64 e time rappresenta una data dopo il 23:59: 59, il 31 dicembre, 3000, UTC.

ctime è una funzione inline che restituisce _ctime64e time_tequivale a __time64_t.Se è necessario che il compilatore per interpretare time_tcome il 32 bit obsoleto time_t, è possibile definire _USE_32BIT_TIME_T.Questa operazione provocherà ctimeper valutare a _ctime32.Questa operazione non è consigliabile perché l'applicazione può non riuscire dopo il 18 gennaio 2038 e non è consentita sulle piattaforme a 64 bit.

Note

ctime la funzione consente di convertire un valore archiviato come time_t valore in una stringa di caratteri.timer il valore è in genere ottenuto da una chiamata a tempo, che restituisce il numero di secondi trascorsi dalla mezzanotte (00:00: 00), il 1° gennaio 1970, formato UTC (UTC).La stringa del valore restituito contiene esattamente 26 caratteri e del form:

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

Un orario in formato 24 ore viene utilizzato.Tutti i campi dispongono di una larghezza costante.Il carattere di nuova riga (" \ n ") e un carattere null (" \ 0 ") occupano le ultime due posizioni della stringa.

La stringa di caratteri convertita viene modificata in base alle impostazioni del fuso orario locale.vedere time, _ftimee localtime funzioni per informazioni sulla configurazione dell'ora locale e _tzset eseguire per informazioni dettagliate sulla definizione dell'ambiente e variabili globali del fuso orario.

una chiamata a ctime modifica di un buffer allocato in modo statico utilizzato da gmtime e localtime funzioni.Ogni chiamata a una di queste routine elimina il risultato della chiamata precedente.ctime condivide un buffer statico con asctime funzione.Pertanto, una chiamata a ctime elimina i risultati di qualsiasi chiamata precedente a asctime, localtime, o gmtime.

_wctime e _wctime64 è la versione a caratteri estesi di ctime e _ctime64; restituire un puntatore a una stringa di caratteri estesi.In caso contrario, _ctime64, _wctimee _wctime64 comportano in modo identico a ctime.

Queste funzioni convalidano i relativi parametri.se timer è un puntatore null, o se il valore del timer è negativo, queste funzioni richiamare il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, il ripristino di funzioni NULL e set errno in EINVAL.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Requisiti

routine	Intestazione di associazione
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> o <wchar.h>
_wctime32	<time.h> o <wchar.h>
_wctime64	<time.h> o <wchar.h>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Esempio

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