ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Artigo
08/25/2010

Converter um time valor em uma seqüência de caracteres e ajuste para o local de time as configurações de zona.Versões mais seguras dessas funções estão disponível; consulte 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 
);

Parâmetros

timer
Ponteiro para a time armazenado.

Valor de retorno

Um ponteiro para o resultado de seqüência de caractere.NULL será retornado se:

time representa uma data antes da meia-noite, 1 º de janeiro de 1970 UTC.
Se você usar _ctime32 ou _wctime32 e time representa uma data após 14: 03: 07 19 de janeiro de 2038.
Se você usar _ctime64 ou _wctime64 e time representa uma data posterior a 23: 59: 59, 31 de dezembro de 3000, UTC.

In Visual C++ 2005, ctime é uma função in-line que é avaliada como _ctime64 e time_t é equivalente a __time64_t. If you need to force the compiler to interpret time_t as the old 32-bit time_t, you can define _USE_32BIT_TIME_T.Isso fará com que ctime a ser avaliada como _ctime32. Isso não é recomendado porque seu aplicativo pode falhar após 18.01.38, e não é permitido em plataformas de 64 bit.

Comentários

The ctime função converte um valor de time armazenado sistema autônomo um time_t valor em uma seqüência de caractere.The timer valor geralmente é obtido de uma telefonar para time, que retorna o número de segundos passados desde meia-noite (00: 00: 00), 1 º de janeiro de 1970 time Universal Coordenado (UTC).A seqüência de caracteres do valor retornado contém exatamente 26 caracteres e tem o seguinte formato:

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

Um relógio de 24 horas é usado.Todos os campos tem uma largura constante.O caractere de nova linha ('\n') e o caractere nulo ('\0') ocupam as duas últimas posições da seqüência de caracteres.

A seqüência de caractere convertida é também ajustada de acordo com a hora local zona configurações.Consulte o time, _ftime, and localTime funções para informações sobre como configurar a time local e o _tzset função para obter detalhes sobre como definir o ambiente de fuso horário e variáveis global.

Uma telefonar para ctime modifica único buffer estaticamente alocado usado pela gmtime e localtime funções. Cada telefonar para um dessas rotinas destrói o resultado da telefonar anterior.ctime compartilha um buffer estático com o asctime função. Assim, uma telefonar para ctime Destrói os resultados de qualquer telefonar anterior a asctime, localtime, ou gmtime.

_wctime e _wctime64 a versão de caractere largo de ctime e _ctime64; retornar um ponteiro para seqüência de caracteres largos. Caso contrário, _ctime64, _wctime, e _wctime64 se comportar de forma idêntica para ctime.

Essas funções validar seus parâmetros.If timer é um ponteiro nulo ou se o valor do timer for negativo, essas funções chamar o manipulador de parâmetro inválido sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, as funções retornam NULL e conjunto errno para EINVAL.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Requisitos

Rotina	Cabeçalho necessário
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> ou <wchar.h>
_wctime32	<time.h> ou <wchar.h>
_wctime64	<time.h> ou <wchar.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

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