ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Artículo
04/10/2013

Convierte un valor de hora a una cadena y ajustelo para que haya configuraciones de zonas de la hora local.Versiones más seguras de estas funciones están disponibles; 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 _ctime64y time_tes equivalente a __time64_t.Si necesita hacer que el compilador para interpretar time_tcomo time_tde 32 bits anterior, puede definir _USE_32BIT_TIME_T.Hacer esto hará ctimeevalú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) (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 NULL return y errno determinado a EINVAL.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H	_UNICODE y _MBCS no definido	_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
}