ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

 

Publicado: octubre de 2016

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Convertir un valor de hora en una cadena y ajustar la configuración de la zona horaria local. Existen versiones más seguras de estas funciones; 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
Puntero a la hora almacenada.

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

  • timeRepresenta una fecha anterior a la medianoche del 1 de enero de 1970 UTC.

  • Si utiliza _ctime32 o _wctime32 y time representa una fecha posterior a las 23:59:59 del 18 de enero de 2038, hora UTC.

  • Si utiliza _ctime64 o _wctime64 y time representa una fecha posterior a las 23:59:59 del 31 de diciembre de 3000, UTC.

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

El ctime función convierte un valor de hora almacenado como un time_t valor en una cadena de caracteres. El timer valor suele obtenerse a partir de una llamada a tiempo, que devuelve el número de segundos transcurrido desde la medianoche (00: 00:00) del 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 nulo ('\0') ocupan las dos últimas posiciones de la cadena.

La cadena de caracteres convertidos también se ajusta según la configuración de zona horaria local. Consulte la time, _ftime, y localtime funciones para obtener información sobre la configuración de la hora local y la _tzset (función) para obtener más información acerca de cómo definir el entorno de zona horaria y variables globales.

Una llamada a ctime modifica el búfer asignado estáticamente único utilizado por el gmtime y localtime funciones. Cada llamada a una de estas rutinas destruye el resultado de la llamada anterior. ctimecomparte un búfer estático con el asctime (función). Por lo tanto, una llamada a ctime destruye los resultados de las llamadas anteriores a asctime, localtime, o gmtime.

_wctimey _wctime64 son la versión de caracteres anchos de ctime y _ctime64; devuelve un puntero a la cadena de caracteres anchos. De lo contrario, _ctime64, _wctime, y _wctime64 se comportan exactamente igual a ctime.

Estas funciones validan sus parámetros. Si timer es un puntero nulo, o si el valor del temporizador es negativo, estas funciones invocan el controlador de parámetros no válidos, como se describe en validación del parámetro. 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
_tctimectimectime_wctime
_tctime32_ctime32_ctime32_wctime32
_tctime64_ctime64_ctime64_wctime64
RutinaEncabezado necesario
ctime<time.h>
_ctime32<time.h>
_ctime64<time.h>
_wctime<time.h>o<wchar.h></wchar.h></time.h>
_wctime32<time.h>o<wchar.h></wchar.h></time.h>
_wctime64<time.h>o<wchar.h></wchar.h></time.h>

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

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

Administración del tiempo
asctime, _wasctime
ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
hora local, _localtime32, _localtime64
tiempo, _time32, _time64

Mostrar: