_strtime, _wstrtime

Copia la hora en un búfer. Hay disponibles versiones más seguras de estas funciones; consulte _strtime_s, _wstrtime_s.

Sintaxis

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 hora.

Valor devuelto

Devuelve un puntero a la cadena de caracteres resultante timestr.

Comentarios

La _strtime función copia la hora local actual en el búfer al que timestrapunta . La hora tiene el formato hh:mm:ss, donde hh es dos dígitos que representan la hora en notación de 24 horas. mm es de dos dígitos durante los minutos pasados de la hora y ss es de dos dígitos durante segundos. Por ejemplo, la cadena 18:23:44 representa 23 minutos y 44 segundos después de 6 p.m. El búfer debe tener al 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 anchos. Por lo demás, estas funciones se comportan exactamente igual. Si timestr es un NULL puntero o si timestr tiene formato incorrecto, se invoca al controlador de parámetros no válidos, como se describe en Validación de parámetros. Si se permite que la excepción continúe, estas funciones devuelven un NULLy se establecen en si era o NULL se establece ERANGEerrnoerrnoEINVAL en si timestrtimestr tiene el formato incorrecto.

En C++, estas funciones tienen sobrecargas de plantilla que invocan los homólogos seguros más recientes de estas funciones. Para obtener más información, consulte Sobrecargas de plantillas seguras.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tstrtime	_strtime	_strtime	_wstrtime

Requisitos

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

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

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 );
}

The current time is 14:21:44

Consulte también

Administración de tiempo
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset