_ftime_s, _ftime32_s, _ftime64_s

 

Publicado: octubre de 2016

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Obtiene la hora actual. Estas son versiones de _ftime, _ftime32, _ftime64 con mejoras de seguridad, como se describe en características de seguridad de CRT.

errno_t _ftime_s(   
   struct _timeb *timeptr   
);  
errno_t _ftime32_s(   
   struct __timeb32 *timeptr   
);  
errno_t _ftime64_s(   
   struct __timeb64 *timeptr   
);  

Parámetros

timeptr
Puntero a un _timeb,``__timeb32, o __timeb64 estructura.

Devuelve cero si se ejecuta correctamente; devuelve un código de error si se produce un error. Si timeptr es NULL, el valor devuelto es EINVAL.

El _ftime_s función obtiene la hora local actual y lo almacena en la estructura que señala timeptr . El _timeb,``__timeb32, y__timeb64 las estructuras se definen en SYS\Timeb.h. Contienen cuatro campos, que se enumeran en la tabla siguiente.

dstflag
Distinto de cero si el horario de verano está en vigor para la zona horaria local. (Consulte _tzset para obtener una explicación de cómo se determina el horario de verano.)

millitm
Fracción de segundo en milisegundos.

time
Tiempo en segundos transcurridos desde la medianoche (00: 00:00) del 1 de enero de 1970, hora universal coordinada (UTC).

timezone
Diferencia en minutos, westward, mover entre la hora UTC y la hora local. El valor de timezone se establece el valor de la variable global _timezone (consulte _tzset).

_ftime64_s, que utiliza la __timeb64 estructura, permite expresar de hasta 23:59:59, hasta el 31 de diciembre de 3000, UTC; las fechas de creación del archivo, mientras que _ftime32_s solo representa fechas hasta las 23:59:59 del 18 de enero de 2038, hora UTC. La noche del 1 de enero de 1970, es el límite inferior del intervalo de fechas para todas estas funciones.

_ftime_ses equivalente a _ftime64_s y _timeb contiene una hora de 64 bits. Esto es así a menos que _USE_32BIT_TIME_T definido, en cuyo caso el comportamiento anterior está en vigor; _ ftime_s usa un tiempo de 32 bits y _timeb contiene una hora de 32 bits.

_ftime_s valida sus parámetros. Si pasa un puntero nulo como timeptr, la función invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, la función establece errno a EINVAL.

FunciónEncabezado necesario
_ftime_sy
_ftime32_sy
_ftime64_sy

Para obtener más información sobre compatibilidad, vea Compatibility en la introducción.

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

// crt_ftime64_s.c  
// This program uses _ftime64_s 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;  
  
   _ftime64_s( &timebuffer );  
  
    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] );  
}  

Seconds since midnight, January 1, 1970 (UTC): 1051553334  
Milliseconds: 230  
Minutes between UTC and local time: 480  
Daylight savings time flag (1 means Daylight time is in effect): 1  
The time is Mon Apr 28 11:08:54.230 2003  

System::DateTime::Now

Administración del tiempo
asctime, _wasctime
CTime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
hora local, _localtime32, _localtime64
tiempo, _time32, _time64

Mostrar: