ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Artículo
06/09/2015

Convierte un valor de hora a una cadena y ajustelo para que haya configuraciones de zonas de la hora local. Hay disponibles versiones más seguras de estas funciones; vea 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
Puntero al tiempo almacenado.

Valor devuelto

Un puntero al resultado de la cadena de caracteres. NULL se devolverá si:

time representa una fecha antes de medianoche, el 1 de enero de 1970, hora UTC.
Si utiliza _ctime32 o _wctime32 y time representa una fecha después de 03:14: 7 de enero de 19, 2038.
Si utiliza _ctime64 o _wctime64 y time representa una fecha después de 23:59: 59, el 31 de diciembre, 3000, la hora UTC.

ctime es una función inline que se evalúa como _ctime64 y time_t es equivalente a __time64_t. Si necesita hacer que el compilador para interpretar time_t como time_tde 32 bits anterior, puede definir _USE_32BIT_TIME_T. Hacer esto hará ctime evalúe _ctime32. Esto no es recomendable porque la aplicación puede producir un error después del 18 de enero de 2038, y no se permite en plataformas de 64 bits.

Comentarios

La función de ctime convierte un valor de hora almacenado como valor de time_t en una cadena de caracteres. El valor de timer se obtiene normalmente de una llamada a tiempo, que devuelve el número de segundos transcurridos desde la medianoche (00:00: 00), el 1 de enero de 1970, hora universal coordinada (UTC). La cadena del valor devuelto contiene exactamente 26 caracteres y tiene el formato:

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

Se utiliza un reloj de 24 horas. Todos los campos tienen un ancho constante. El carácter de nueva línea (“\n ") y el carácter null (“\0”) ocupan las dos últimas posiciones de la cadena.

Cadena de caracteres convierte también se ajusta según la configuración de zonas de la hora local. Vea time, _ftime, y las funciones de localtime para obtener información sobre la configuración de la hora local y la función de _tzset para obtener más información sobre la definición del entorno y las variables globales de la zona horaria.

Una llamada a ctime modifica el único búfer estáticamente asignado utilizado por gmtime y localtime funciona. Cada llamada a una de estas rutinas destruye el resultado de la llamada anterior. ctime comparte un buffer estático con la función de asctime . Así, una llamada a ctime destruye los resultados de cualquier llamada anterior a asctime, a localtime, o a gmtime.

_wctime y _wctime64 son la versión con caracteres anchos de ctime y _ctime64; devolver un puntero a la cadena de caracteres. Si no, _ctime64, _wctime, y _wctime64 se comportan de forma idéntica a ctime.

Estas funciones validan sus parámetros. Si timer es un puntero null, o si el valor del temporizador es negativo, estas funciones se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros. Si la ejecución puede continuar, las funciones devuelven NULL y establecen errno en EINVAL.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Requisitos

Rutina	Encabezado necesario
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 <>

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

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