_ftime, _ftime32, _ftime64

Ottiene l'ora corrente. Sono disponibili versioni più sicure di queste funzioni; vedere _ftime_s, _ftime32_s, _ftime64_s.

Sintassi

void _ftime( struct _timeb *timeptr );
void _ftime32( struct __timeb32 *timeptr );
void _ftime64( struct __timeb64 *timeptr );

Parametri

timeptr
Puntatore a una _timebstruttura , __timeb32o __timeb64 .

Osservazioni:

La _ftime funzione ottiene l'ora locale corrente e la archivia nella struttura a timeptrcui punta . Le _timebstrutture , __timeb32e __timeb64 sono definite in <sys\timeb.h>. Le strutture contengono quattro valori, elencati nella tabella seguente.

Campo	Descrizione
dstflag	Diverso da zero se l'ora legale è in vigore per il fuso orario locale. Per _tzset una spiegazione del modo in cui viene determinata l'ora legale, vedere .
millitm	Frazione di secondo in millisecondi.
time	Ora in secondi trascorsi dalla mezzanotte (00.00.00) del 1 gennaio 1970 nel formato UTC (Coordinated Universal Time).
timezone	La differenza in minuti, in direzione ovest, tra l'ora UTC e l'ora locale. Il valore di timezone viene impostato dal valore della variabile globale _timezone (vedere _tzset).

La _ftime64 funzione , che usa la __timeb64 struttura , consente di esprimere le date di creazione di file fino alle 23.59.59 del 31 dicembre 3000 UTC, mentre _ftime32 rappresenta solo le date fino alle 23.59.59 del 18 gennaio 2038, UTC. La mezzanotte del 1 gennaio 1970 è il limite inferiore dell'intervallo di date per tutte queste funzioni.

La _ftime funzione è equivalente a e _timeb contiene un tempo a _ftime6464 bit, a meno che non _USE_32BIT_TIME_T sia definito, nel qual caso il comportamento precedente è attivo; _ftime usa un'ora a 32 bit e _timeb contiene un tempo a 32 bit.

_ftime convalida i propri parametri. Se è stato passato un puntatore Null come timeptr, la funzione richiama il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione imposta errno su EINVAL.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Funzione	Intestazione obbligatoria
_ftime	<sys/types.h> e <sys/timeb.h>
_ftime32	<sys/types.h> e <sys/timeb.h>
_ftime64	<sys/types.h> e <sys/timeb.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

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

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

Vedi anche

Gestione orari
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32_wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64