_ftime, _ftime32, _ftime64
Obtiene la hora actual.Versiones más seguras de estas funciones están disponibles; vea _ftime_s, _ftime32_s, _ftime64_s.
void _ftime(
struct _timeb *timeptr
);
void _ftime32(
struct __timeb32 *timeptr
);
void _ftime64(
struct __timeb64 *timeptr
);
Parámetros
- timeptr
Puntero a _timeb,a__timeb32 o estructura de __timeb64 .
Comentarios
La función de _ftime obtiene la hora local y la almacena en la estructura designada por a timeptr*.*_timeb, __timeb32,ylas estructuras de__timeb64 son definidas en SYS \Timeb .h.contienen cuatro campos, que se enumeran en la tabla siguiente.
dstflag
Distinto de cero si el horario de verano está actualmente en vigor para la zona horaria local.(Vea _tzset para obtener una explicación de cómo se determina el horario de verano.)millitm
fracción segundo en milisegundos.time
tiempo en segundos desde la medianoche (00:00: 00), el 1 de enero de 1970, hora universal coordinada (UTC) (UTC).timezone
Diferencia en minutos, desplazándose hacia el oeste, entre la hora utc y la hora local.El valor de timezone se establece el valor de la variable global _timezone (vea _tzset).
_ftime64, que utiliza la estructura de __timeb64 , permite que las fechas de creación de archivos se expresadas hacia arriba con 23:59: 59, el 31 de diciembre, 3000, hora UTC; mientras que _ftime32 sólo representa las fechas con 03:14: 7 de enero de 19, 2038, La hora UTC.La medianoche, el 1 de enero de 1970, es el límite inferior del intervalo de fechas para todas estas funciones.
_ftime es equivalente a _ftime64 y _timeb contiene una hora 64 bits.Esto es así a menos que _USE_32BIT_TIME_T está definido, en cuyo caso el comportamiento antiguo está vigente; _ftime utiliza un período de 32 bits y _timeb contiene un plazo de 32 bits.
_ftime valida sus parámetros.Si se pasa un puntero NULL como timeptr, la función 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, la función establece errno a EINVAL.
Requisitos
Función |
Encabezado necesario |
---|---|
_ftime |
<sistema/types.h> y <sistema/timeb.h> |
_ftime32 |
<sistema/types.h> y <sistema/timeb.h> |
_ftime64 |
<sistema/types.h> y <sistema/timeb.h> |
Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.
Ejemplo
// crt_ftime.c
// compile with: /W3
// This program uses _ftime to obtain the current
// time and then stores this time in timebuffer.
#include <stdio.h>
#include <sys/timeb.h>
#include <time.h>
int main( void )
{
struct _timeb timebuffer;
char timeline[26];
errno_t err;
time_t time1;
unsigned short millitm1;
short timezone1;
short dstflag1;
_ftime( &timebuffer ); // C4996
// Note: _ftime is deprecated; consider using _ftime_s instead
time1 = timebuffer.time;
millitm1 = timebuffer.millitm;
timezone1 = timebuffer.timezone;
dstflag1 = timebuffer.dstflag;
printf( "Seconds since midnight, January 1, 1970 (UTC): %I64d\n",
time1);
printf( "Milliseconds: %d\n", millitm1);
printf( "Minutes between UTC and local time: %d\n", timezone1);
printf( "Daylight savings time flag (1 means Daylight time is in "
"effect): %d\n", dstflag1);
err = ctime_s( timeline, 26, & ( timebuffer.time ) );
if (err)
{
printf("Invalid argument to ctime_s. ");
}
printf( "The time is %.19s.%hu %s", timeline, timebuffer.millitm,
&timeline[20] );
}
Equivalente en .NET Framework
Vea también
Referencia
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64