Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s

Convierte un valor de hora a una cadena y lo ajusta para la configuración de zona horaria local. Éstas son versiones de ctime, _ctime64, _wctime, _wctime64 con mejoras de seguridad como se describe en Características de seguridad de CRT.

errno_t ctime_s( 
   char* buffer,
   size_t numberOfElements,
   const time_t *time 
);
errno_t _ctime32_s( 
   char* buffer,
   size_t numberOfElements,
   const __time32_t *time 
);
errno_t _ctime64_s( 
   char* buffer,
   size_t numberOfElements,
   const __time64_t *time )
;
errno_t _wctime_s( 
   wchar_t* buffer,
   size_t numberOfElements,
   const time_t *time 
);
errno_t _wctime32_s( 
   wchar_t* buffer,
   size_t numberOfElements,
   const __time32_t *time 
);
errno_t _wctime64_s( 
   wchar_t* buffer,
   size_t numberOfElements,
   const __time64_t *time 
);
template <size_t size>
errno_t _ctime32_s( 
   char (&buffer)[size],
   const __time32_t *time 
); // C++ only
template <size_t size>
errno_t _ctime64_s( 
   char (&buffer)[size],
   const __time64_t *time
); // C++ only
template <size_t size>
errno_t _wctime32_s( 
   wchar_t (&buffer)[size],
   const __time32_t *time 
); // C++ only
template <size_t size>
errno_t _wctime64_s( 
   wchar_t (&buffer)[size],
   const __time64_t *time 
); // C++ only

[out] buffer

Debe ser lo suficientemente grande para contener 26 caracteres. Un puntero al resultado de la cadena de caracteres, o NULLsi:

  • time representa una fecha antes de medianoche, el 1 de enero de 1970, hora UTC.

  • Si utiliza _ctime32_s o _wctime32_s y time representa una fecha después de 03:14: 7 de enero de 19, 2038.

  • Si utiliza _ctime64_s o _wctime64_s y time representa una fecha después de 23:59: 59, el 31 de diciembre, 3000, la hora UTC.

  • Si utiliza _ctime_s o _wctime_s, estas funciones son contenedores a las funciones anteriores. Vea la sección Comentarios.

[in] numberOfElements

Tamaño del búfer.

[in] time

Puntero al tiempo almacenado.

Cero si correctamente. Si hay un error debido a un parámetro no válido, 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, se devuelve un código de error. Los códigos de error se definen en ERRNO.H; para obtener una lista de estos errores, vea errno. Los códigos de error reales lanzados para cada condición de error se muestran en la tabla siguiente.

buffer

numberOfElements

time

Devolución

Valor de buffer

NULL

any

any

EINVAL

No modificado

No NULL (señala memoria válido)

0

any

EINVAL

No modificado

No NULL

0< talla 26 <

any

EINVAL

Cadena vacía

No NULL

>= 26

NULL

EINVAL

Cadena vacía

No NULL

>= 26

< 0

EINVAL

Cadena vacía

La función de ctime_s convierte un valor de hora almacenado como una estructura de time_t en una cadena de caracteres. El valor de time 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 localtime32_s para obtener información sobre la configuración de la hora local y la función de _tzset para obtener información sobre la definición del entorno y las variables globales de la zona horaria.

_wctime32_s y _wctime64_s son la versión con caracteres anchos de _ctime32_s y _ctime64_s; devolver un puntero a la cadena de caracteres. Si no, _ctime64_s, _wctime32_s, y _wctime64_s se comportan de forma idéntica a _ctime32_s.

ctime_s es una función inline que se evalúa como _ctime64_s 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_s evalúe _ctime32_s. 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.

En C++, el uso de estas funciones se simplifica mediante sobrecargas de plantilla. Las sobrecargas pueden deducir la longitud del búfer automáticamente, lo que elimina la necesidad de especificar un argumento de tamaño. Para obtener más información, vea Sobrecargas de plantilla seguras.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tctime_s

ctime_s

ctime_s

_wctime_s

_tctime32_s

_ctime32_s

_ctime32_s

_wctime32_s

_tctime64_s

_ctime64_s

_ctime64_s

_wctime64_s

Rutina

Encabezado necesario

ctime_s,

_ctime32_s,

_ctime64_s

<time.h>

_wctime_s,

_wctime32_s,

_wctime64_s

<time.h o> wchar.h <>

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

Bibliotecas

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

// crt_wctime_s.c
/* This program gets the current
 * time in time_t form and then uses _wctime_s to
 * display the time in string form.
 */

#include <time.h>
#include <stdio.h>

#define SIZE 26

int main( void )
{
   time_t ltime;
   wchar_t buf[SIZE];
   errno_t err;

   time( &ltime );

  
   err = _wctime_s( buf, SIZE, &ltime );
   if (err != 0)
   {
      printf("Invalid Arguments for _wctime_s. Error Code: %d\n", err);
   }
   wprintf_s( L"The time is %s\n", buf );
}

The time is Fri Apr 25 13:03:39 2003

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft