ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Artigo
06/09/2015

Converter um valor do tempo como uma cadeia de caracteres e ajuste-o para configurações de fuso horário local. Versões mais seguras dessas funções estão disponíveis; 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 o momento armazenados.

Valor de retorno

Um ponteiro para o resultado da cadeia de caracteres. NULL será retornado se:

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

ctime é uma função embutida que é avaliada para _ctime64 e time_t é equivalente a __time64_t. Se você precisar forçar o compilador para interpretar time_t como time_tde 32 bits antigo, você pode definir _USE_32BIT_TIME_T. Isso fará com que ctime é avaliada para _ctime32. Isso não é recomendado porque seu aplicativo pode falhar depois do 18 de janeiro de 2038, e não é permitido em plataformas de 64 bits.

Comentários

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

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

Um relógio de 24 horas é usado. Todos os campos têm uma largura constante. O caractere de nova linha (\ n “") e o caractere nulo (\) “0 " ocupam as duas posições as mais recentes de cadeia de caracteres.

A cadeia de caracteres convertida também é ajustada de acordo com as configurações de fuso horário local. Consulte time, _ftime, e as funções de localtime para obter informações sobre como configurar a hora local e a função de _tzset para obter detalhes sobre a definição do ambiente de fuso horário e variáveis globais.

Uma chamada para ctime altera o único buffer estaticamente atribuído usada pela funções de gmtime e de localtime . Cada chamada para uma dessas rotinas destrói o resultado da chamada anterior. ctime compartilha um buffer estático com a função de asctime . Assim, uma chamada a ctime destrói os resultados de qualquer chamada anterior a asctime, a localtime, ou a gmtime.

_wctime e _wctime64 é a versão de ampla caractere de ctime e _ctime64; retornando um ponteiro para a cadeia de caracteres de ampla caractere. Caso contrário, _ctime64, _wctime, e _wctime64 se comportam idêntica a ctime.

Essas funções validam seus parâmetros. Se timer for um ponteiro nulo, ou se o valor de timer for negativo, essas funções invoca o manipulador inválido do parâmetro, conforme descrito em Validação do parâmetro. Se a execução puder continuar, as funções retornarão NULL e definirão errno como EINVAL.

Mapeamentos da rotina de texto genérico

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