_strtime, _wstrtime

Artículo
04/10/2013

Copie el tiempo en un búfer.Versiones más seguras de estas funciones están disponibles; vea _strtime_s, _wstrtime_s.

char *_strtime(
   char *timestr 
);
wchar_t *_wstrtime(
   wchar_t *timestr 
);
template <size_t size>
char *_strtime(
   char (&timestr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrtime(
   wchar_t (&timestr)[size]
); // C++ only

Parámetros

timestr
cadena de tiempo.

Valor devuelto

devuelve un puntero a la cadena de caracteres resultante timestr.

Comentarios

La función de _strtime copia la hora local actual en el búfer indicada por timestr*.* El tiempo se le da formato a hh:mm:ss donde dos dígitos hh que representan la hora en la notación de 24 horas, mm es dos dígitos que representan los minutos más allá de la hora, y ss es dos dígitos que representan segundos.por ejemplo, la cadena 18:23:44 representa 23 minutos y 44 segundos más allá 6 de la tarde.El búfer debe ser por lo menos 9 bytes de longitud.

_wstrtime es una versión con caracteres anchos de _strtime; el argumento y el valor devuelto de _wstrtime son cadenas de caracteres.Estas funciones se comportan exactamente igual de otra manera. Si timestr es un puntero de NULL o si timestr se da formato incorrectamente, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la excepción puede continuar, estas funciones devuelven un valor NULL y errno determinado a EINVAL si timestr era NULL o errno determinado a ERANGE si timestr se da formato incorrecto.

En C++, estas funciones tienen sobrecargas de plantilla que se invoque según el nuevo, garantiza que sus homólogos de estas funciones.Para obtener más información, vea Sobrecargas de plantilla de seguridad.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H	_UNICODE y _MBCS no definido	_MBCS definido	_UNICODE definido
_tstrtime	_strtime	_strtime	_wstrtime

Requisitos

rutina	Encabezado necesario
_strtime	<time.h>
_wstrtime	<time.h> o <wchar.h>

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

Ejemplo

// crt_strtime.c
// compile with: /W3

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

int main( void )
{
   char tbuffer [9];
   _strtime( tbuffer ); // C4996
   // Note: _strtime is deprecated; consider using _strtime_s instead
   printf( "The current time is %s \n", tbuffer );
}