Classe CFileTime

  • Articolo

Questa classe fornisce metodi per gestire i valori di data e ora associati a un file.

Sintassi

class CFileTime :  public FILETIME

Membri

Costruttori pubblici

Nome Descrizione
CFileTime::CFileTime Costruttore.

Metodi pubblici

Nome Descrizione
CFileTime::GetCurrentTime Chiamare questa funzione statica per recuperare un CFileTime oggetto che rappresenta la data e l'ora di sistema correnti.
CFileTime::GetTime Chiamare questo metodo per recuperare l'ora dall'oggetto CFileTime .
CFileTime::LocalToUTC Chiamare questo metodo per convertire un'ora del file locale in un'ora di file in base all'ora UTC (Coordinated Universal Time).
CFileTime::SetTime Chiamare questo metodo per impostare la data e l'ora archiviate dall'oggetto CFileTime .
CFileTime::UTCToLocal Chiamare questo metodo per convertire l'ora in base all'ora UTC (Coordinated Universal Time) all'ora del file locale.

Operatori pubblici

Nome Descrizione
CFileTime::operator - Questo operatore viene usato per eseguire la sottrazione su un CFileTime oggetto o CFileTimeSpan .
CFileTime::operator != Questo operatore confronta due CFileTime oggetti per verificare la disuguaglianza.
CFileTime::operator + Questo operatore viene usato per eseguire l'addizione su un oggetto CFileTimeSpan.
CFileTime::operator += Questo operatore viene usato per eseguire l'addizione su un oggetto CFileTimeSpan e per assegnare il risultato all'oggetto corrente.
CFileTime::operator < Questo operatore confronta due oggetti CFileTime per determinare il minore.
CFileTime::operator <= Questo operatore confronta due oggetti CFileTime per determinare l'uguaglianza o il minore.
CFileTime::operator = Operatore di assegnazione .
CFileTime::operator -= Questo operatore viene usato per eseguire la sottrazione su un CFileTimeSpan oggetto e assegnare il risultato all'oggetto corrente.
CFileTime::operator == Questo operatore confronta due oggetti CFileTime per stabilirne l'uguaglianza.
CFileTime::operator > Questo operatore confronta due oggetti CFileTime per determinare il più grande.
CFileTime::operator >= Questo operatore confronta due oggetti CFileTime per determinare l'uguaglianza o il più grande.

Costanti pubbliche

Nome Descrizione
CFileTime::Day Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un giorno.
CFileTime::Hour Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un'ora.
CFileTime::Millisecond Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un millisecondo.
CFileTime::Minute Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un minuto.
CFileTime::Second Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un secondo.
CFileTime::Week Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono una settimana.

Osservazioni:

Questa classe fornisce metodi per gestire i valori di data e ora associati alla creazione, all'accesso e alla modifica dei file. I metodi e i dati di questa classe vengono spesso usati insieme agli CFileTimeSpan oggetti , che gestiscono i valori temporali relativi.

Il valore di data e ora viene archiviato come valore a 64 bit che rappresenta il numero di intervalli di 100 nanosecondi dal 1° gennaio 1601. Questo formato è il formato UTC (Coordinated Universal Time).

Per semplificare i calcoli vengono fornite le variabili membro const statiche seguenti:

Variabile membro Numero di intervalli di 100 nanosecondi
Millisecond 10,000
Secondo Millisecondo * 1.000
Minute Secondo * 60
Ora Minuto * 60
Giornaliera Ora * 24
Settimana Giorno * 7

Nota

Non tutti i file system possono registrare la creazione e l'ora dell'ultimo accesso e non tutti i file system li registrano nello stesso modo. Ad esempio, nel file system FAT di Windows NT, il tempo di creazione ha una risoluzione di 10 millisecondi, l'ora di scrittura ha una risoluzione di 2 secondi e l'ora di accesso ha una risoluzione di 1 giorno (la data di accesso). In NTFS, l'ora di accesso ha una risoluzione di 1 ora. Inoltre, FAT registra i tempi su disco nell'ora locale, ma i record NTFS volte sul disco in formato UTC. Per altre informazioni, vedere Orari dei file.

Gerarchia di ereditarietà

FILETIME
 └ CFileTime

Requisiti

Intestazione: atltime.h

CFileTime::CFileTime

Costruttore.

CFileTime() throw();
CFileTime(const FILETIME& ft) throw();
CFileTime(ULONGLONG nTime) throw();

Parametri

ft
Struttura FILETIME.

nTime
Data e ora espresse come valore a 64 bit.

Osservazioni:

L'oggetto CFileTime può essere creato usando una data e un'ora esistenti da una FILETIME struttura o espressa come valore a 64 bit (in formati ora UTC (Coordinated Universal Time). Il costruttore predefinito imposta l'ora su 0.

CFileTime::Day

Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un giorno.

static const ULONGLONG Day = Hour* 24;

Esempio

Vedere l'esempio per CFileTime::Millisecond.

CFileTime::GetCurrentTime

Chiamare questa funzione statica per recuperare un CFileTime oggetto che rappresenta la data e l'ora di sistema correnti.

static CFileTime GetCurrentTime() throw();

Valore restituito

Restituisce la data e l'ora di sistema correnti in formato UTC (Coordinated Universal Time).

Esempio

// Retrieve the current time
CFileTime myFT;
myFT = CFileTime::GetCurrentTime();

CFileTime::GetTime

Chiamare questo metodo per recuperare l'ora dall'oggetto CFileTime .

ULONGLONG GetTime() const throw();

Valore restituito

Restituisce la data e l'ora come numero a 64 bit, che può essere in formato UTC (Coordinated Universal Time).

CFileTime::Hour

Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un'ora.

static const ULONGLONG Hour = Minute* 60;

Esempio

Vedere l'esempio per CFileTime::Millisecond.

CFileTime::LocalToUTC

Chiamare questo metodo per convertire un'ora del file locale in un'ora di file in base all'ora UTC (Coordinated Universal Time).

CFileTime LocalToUTC() const throw();

Valore restituito

Restituisce un CFileTime oggetto contenente l'ora in formato UTC.

Esempio

Vedere l'esempio per CFileTime::UTCToLocal.

CFileTime::Millisecond

Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un millisecondo.

static const ULONGLONG Millisecond = 10000;

Esempio

// Calculate the difference between two times
CFileTime myFT1, myFT2;
CFileTimeSpan myFTS;

// Get the first time
myFT1 = CFileTime::GetCurrentTime();

// Pause for a moment
UINT randVal;
rand_s(&randVal);
Sleep(randVal % 10000);

// Get the second time
myFT2 = CFileTime::GetCurrentTime();

// Calculate the time difference
myFTS = myFT2 - myFT1;

// Measure the difference
if (myFTS.GetTimeSpan() < CFileTime::Minute)
   printf_s("Less than a minute passed\n");
else
   printf_s("A minute or more passed\n");

if (myFTS.GetTimeSpan() < CFileTime::Second)
   printf_s("Less than a second passed\n");
else
   printf_s("A second or more passed\n");

if (myFTS.GetTimeSpan() < CFileTime::Millisecond)
   printf_s("Less than a millisecond passed\n");
else
   printf_s("A millisecond or more passed\n");

CFileTime::Minute

Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un minuto.

static const ULONGLONG Minute = Second* 60;

Esempio

Vedere l'esempio per CFileTime::Millisecond.

CFileTime::operator -

Questo operatore viene usato per eseguire la sottrazione su un CFileTime oggetto o CFileTimeSpan .

CFileTime operator-(CFileTimeSpan span) const throw();
CFileTimeSpan operator-(CFileTime ft) const throw();

Parametri

span
Oggetto CFileTimeSpan.

ft
Oggetto CFileTime.

Valore restituito

Restituisce un CFileTime oggetto o un CFileTimeSpan oggetto che rappresenta il risultato della differenza di tempo tra i due oggetti.

CFileTime::operator !=

Questo operatore confronta due CFileTime oggetti per verificare la disuguaglianza.

bool operator!=(CFileTime ft) const throw();

Parametri

ft
L'oggetto CFileTime da confrontare.

Valore restituito

Restituisce TRUE se l'elemento confrontato non è uguale all'oggetto CFileTime ; in caso contrario FALSE, .

CFileTime::operator +

Questo operatore viene usato per eseguire l'addizione su un oggetto CFileTimeSpan.

CFileTime operator+(CFileTimeSpan span) const throw();

Parametri

span
Oggetto CFileTimeSpan.

Valore restituito

Restituisce un CFileTime oggetto che rappresenta il risultato dell'ora originale più un tempo relativo.

CFileTime::operator +=

Questo operatore viene usato per eseguire l'addizione su un oggetto CFileTimeSpan e per assegnare il risultato all'oggetto corrente.

CFileTime& operator+=(CFileTimeSpan span) throw();

Parametri

span
Oggetto CFileTimeSpan.

Valore restituito

Restituisce l'oggetto aggiornato CFileTime , che rappresenta il risultato dell'ora originale più un tempo relativo.

CFileTime::operator <

Questo operatore confronta due oggetti CFileTime per determinare il minore.

bool operator<(CFileTime ft) const throw();

Parametri

ft
L'oggetto CFileTime da confrontare.

Valore restituito

Restituisce TRUE se il primo oggetto è minore (in precedenza nel tempo) rispetto al secondo, FALSE in caso contrario.

Esempio

// Test for one time less than another
// Declare the CFileType objects
CFileTime myFT1, myFT2;

// Obtain the first time value
myFT1 = CFileTime::GetCurrentTime();

// Pause for a moment...
Sleep(1000);

// Obtain the second time value
myFT2 = CFileTime::GetCurrentTime();

// Perform the comparison
if (myFT1 < myFT2)
   _tprintf_s(_T("Time is going in the correct direction.\n"));
else
   _tprintf_s(_T("Oh dear. Time is going backwards.\n"));

CFileTime::operator <>=

Questo operatore confronta due oggetti CFileTime per determinare l'uguaglianza o il minore.

bool operator<=(CFileTime ft) const throw();

Parametri

ft
L'oggetto CFileTime da confrontare.

Valore restituito

Restituisce TRUE se il primo oggetto è minore di (precedente nel tempo) o uguale al secondo; in caso contrario FALSE, .

CFileTime::operator =

Operatore di assegnazione .

CFileTime& operator=(const FILETIME& ft) throw();

Parametri

ft
Oggetto CFileTime contenente la nuova ora e la nuova data.

Valore restituito

Restituisce l'oggetto aggiornato CFileTime .

CFileTime::operator -=

Questo operatore viene usato per eseguire la sottrazione su un CFileTimeSpan oggetto e assegnare il risultato all'oggetto corrente.

CFileTime& operator-=(CFileTimeSpan span) throw();

Parametri

span
Oggetto CFileTimeSpan contenente il tempo relativo da sottrarre.

Valore restituito

Restituisce l'oggetto aggiornato CFileTime .

CFileTime::operator ==

Questo operatore confronta due oggetti CFileTime per stabilirne l'uguaglianza.

bool operator==(CFileTime ft) const throw();

Parametri

ft
Oggetto CFileTime da confrontare.

Valore restituito

Restituisce TRUE se gli oggetti sono uguali, in caso contrario FALSE.

CFileTime::operator >

Questo operatore confronta due oggetti CFileTime per determinare il più grande.

bool operator>(CFileTime ft) const throw();

Parametri

ft
L'oggetto CFileTime da confrontare.

Valore restituito

Restituisce TRUE se il primo oggetto è maggiore di (successivo nel tempo) rispetto al secondo; in caso contrario FALSE, .

CFileTime::operator >=

Questo operatore confronta due oggetti CFileTime per determinare l'uguaglianza o il più grande.

bool operator>=(CFileTime ft) const throw();

Parametri

ft
L'oggetto CFileTime da confrontare.

Valore restituito

Restituisce TRUE se il primo oggetto è maggiore di (più avanti nel tempo) o uguale al secondo; in caso contrario FALSE, .

CFileTime::Second

Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono un giorno.

static const ULONGLONG Second = Millisecond* 1000;

Esempio

Vedere l'esempio per CFileTime::Millisecond.

CFileTime::SetTime

Chiamare questo metodo per impostare la data e l'ora archiviate dall'oggetto CFileTime .

void SetTime(ULONGLONG nTime) throw();

Parametri

nTime
Valore a 64 bit che rappresenta la data e l'ora, in formato UTC (Coordinated Universal Time).

CFileTime::UTCToLocal

Chiamare questo metodo per convertire l'ora in base all'ora UTC (Coordinated Universal Time) all'ora del file locale.

CFileTime UTCToLocal() const throw();

Valore restituito

Restituisce un CFileTime oggetto contenente l'ora nel formato dell'ora del file locale.

Esempio

// Convert a UTC time to local file time format
CFileTime myUTC_FT, myL_FT;
// Get system time (in UTC format)
myUTC_FT = CFileTime::GetCurrentTime();
// Convert to local file time
myL_FT = myUTC_FT.UTCToLocal();

CFileTime::Week

Membro dati statico che archivia il numero di intervalli di 100 nanosecondi che costituiscono una settimana.

static const ULONGLONG Week = Day* 7;

Esempio

Vedere l'esempio per CFileTime::Millisecond.

Vedi anche

FILETIME
Classe CFileTimeSpan
Grafico gerarchia
Classi condivise ATL/MFC