_strtime, _wstrtime
Copie el tiempo en un búfer. Hay disponibles versiones más seguras de estas funciones; vea _strtime_s, _wstrtime_s.
char *_strtime(
char *timestr
);
wchar_t *_wstrtime(
wchar_t *timestr
);
template <size_t size>
char *_strtime(
char (×tr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrtime(
wchar_t (×tr)[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 anchos. 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 invocan los homólogos seguros más recientes de estas funciones. 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 |
---|---|---|---|
_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 );
}
Equivalente en .NET Framework
Vea también
Referencia
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64