a ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Artigo
02/25/2013

Converter um valor de tempo em uma seqüência de caracteres e ajuste de configurações de fuso horário local.Versões mais seguras dessas funções estão disponíveis; see 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 o tempo armazenado.

Valor de retorno

Um ponteiro para o resultado da seqüência de caracteres.NULLserá retornado se:

timerepresenta uma data anterior à meia-noite de 1º de janeiro de 1970, UTC.
Se você usar _ctime32 ou _wctime32 e time representa uma data após 03: 14: 07 em 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, a UTC.

ctimeé uma função in-line que é avaliada como _ctime64 e time_t é equivalente a __time64_t.Se você precisar forçar o compilador para interpretar time_t como o antigo 32-bit time_t, você pode definir _USE_32BIT_TIME_T.Fazendo isso fará com que ctime a ser avaliada como _ctime32.Isso não é recomendado porque seu aplicativo pode falhar após 18 de janeiro de 2038, e não é permitido em plataformas de 64 bits.

Comentários

O ctime função converte um valor de tempo armazenado como um time_t o valor em uma seqüência de caracteres.O timer valor geralmente é obtido de uma chamada para tempo, que retorna o número de segundos passado desde meia-noite (00: 00), 1 de janeiro de 1970, hora universal coordenada (UTC).A seqüência de caracteres do valor de retorno contém exatamente 26 caracteres e tem o seguinte formato:

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

É usado um relógio de 24 horas.Todos os campos tem uma largura de 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 caracteres convertidas também é ajustada de acordo com as configurações de fuso horário local.Consulte o time, _ftime, e localtime funções para informações sobre como configurar a hora local e o _tzset a função para obter detalhes sobre como definir o ambiente de fuso horário e variáveis globais.

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

_wctimee _wctime64 são da versão de caractere largo de ctime e _ctime64; retornando um ponteiro para a cadeia de caracteres largos.Otherwise, _ctime64, _wctime, and _wctime64 behave identically to ctime.

Essas funções validam seus parâmetros.Se timer é um ponteiro nulo ou se o valor do timer for negativo, essas funções chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, as funções retornam NULL e defina errno para EINVAL.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo 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 de 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
}