Classe `CFileTime`

Article
10/12/2023

Cette classe fournit des méthodes pour gérer les valeurs de date et d’heure associées à un fichier.

Syntaxe

class CFileTime :  public FILETIME

Membres

Constructeurs publics

Nom	Description
`CFileTime::CFileTime`	Constructeur .

Méthodes publiques

Nom	Description
`CFileTime::GetCurrentTime`	Appelez cette fonction statique pour récupérer un `CFileTime` objet qui représente la date et l’heure système actuelles.
`CFileTime::GetTime`	Appelez cette méthode pour récupérer l’heure à partir de l’objet `CFileTime` .
`CFileTime::LocalToUTC`	Appelez cette méthode pour convertir une heure de fichier locale en heure de fichier en fonction du temps universel coordonné (UTC).
`CFileTime::SetTime`	Appelez cette méthode pour définir la date et l’heure stockées par l’objet `CFileTime` .
`CFileTime::UTCToLocal`	Appelez cette méthode pour convertir l’heure en temps universel coordonné (UTC) en heure de fichier locale.

Opérateurs publics

Nom	Description
`CFileTime::operator -`	Cet opérateur est utilisé pour effectuer la soustraction sur un ou `CFileTimeSpan` un `CFileTime` objet.
`CFileTime::operator !=`	Cet opérateur compare deux `CFileTime` objets pour l’inégalité.
`CFileTime::operator +`	Cet opérateur permet d'effectuer une addition sur un objet `CFileTimeSpan`.
`CFileTime::operator +=`	Cet opérateur permet d'effectuer une addition sur un objet `CFileTimeSpan` et d'assigner le résultat à l'objet actuel.
`CFileTime::operator <`	Cet opérateur compare deux objets `CFileTime` pour déterminer le plus petit.
`CFileTime::operator <=`	Cet opérateur compare deux objets `CFileTime` pour déterminer le plus petit ou leur égalité.
`CFileTime::operator =`	Opérateur d’assignation .
`CFileTime::operator -=`	Cet opérateur est utilisé pour effectuer la soustraction sur un `CFileTimeSpan` objet et affecter le résultat à l’objet actuel.
`CFileTime::operator ==`	Cet opérateur compare deux objets `CFileTime` pour déterminer leur égalité.
`CFileTime::operator >`	Cet opérateur compare deux objets `CFileTime` pour déterminer le plus grand.
`CFileTime::operator >=`	Cet opérateur compare deux objets `CFileTime` pour déterminer le plus grand ou leur égalité.

Constantes publiques

Nom	Description
`CFileTime::Day`	Membre de données statique qui stocke le nombre d’intervalles de 100 nanosecondes qui composent un jour.
`CFileTime::Hour`	Membre de données statiques stockant le nombre d’intervalles de 100 nanosecondes qui composent une heure.
`CFileTime::Millisecond`	Membre de données statiques stockant le nombre d’intervalles de 100 nanosecondes qui constituent une milliseconde.
`CFileTime::Minute`	Membre de données statiques stockant le nombre d’intervalles de 100 nanosecondes qui composent une minute.
`CFileTime::Second`	Membre de données statiques stockant le nombre d’intervalles de 100 nanosecondes qui composent une seconde.
`CFileTime::Week`	Membre de données statiques stockant le nombre d’intervalles de 100 nanosecondes qui composent une semaine.

Notes

Cette classe fournit des méthodes pour gérer les valeurs de date et d’heure associées à la création, à l’accès et à la modification des fichiers. Les méthodes et les données de cette classe sont fréquemment utilisées avec des CFileTimeSpan objets, qui traitent des valeurs de temps relatives.

La valeur de date et d’heure est stockée sous forme de valeur 64 bits représentant le nombre d’intervalles de 100 nanosecondes depuis le 1er janvier 1601. Ce format est le format UTC (Temps universel coordonné).

Les variables membres const statiques suivantes sont fournies pour simplifier les calculs :

Variable membre	Nombre d’intervalles de 100 nanosecondes
Milliseconde	10 000
Second	Milliseconde * 1 000
Minute	Deuxième * 60
Heure	Minute * 60
Day	Heure * 24
Week	Jour * 7

Remarque

Tous les systèmes de fichiers ne peuvent pas enregistrer la création et la dernière heure d’accès, et tous les systèmes de fichiers ne les enregistrent pas de la même manière. Par exemple, sur le système de fichiers Windows NT FAT, l’heure de création a une résolution de 10 millisecondes, l’heure d’écriture a une résolution de 2 secondes et l’heure d’accès a une résolution de 1 jour (la date d’accès). Sur NTFS, l’heure d’accès a une résolution de 1 heure. En outre, FAT enregistre des heures sur le disque en temps local, mais NTFS enregistre des heures sur le disque au format UTC. Pour plus d’informations, consultez Les heures de fichier.

Hiérarchie d’héritage

FILETIME
└ CFileTime

Spécifications

En-tête : atltime.h

`CFileTime::CFileTime`

Constructeur .

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

Paramètres

ft
Structure FILETIME.

nTime
Date et heure exprimées sous forme de valeur 64 bits.

Notes

L’objet CFileTime peut être créé à l’aide d’une date et d’une heure existantes à partir d’une FILETIME structure, ou exprimée sous forme de valeur 64 bits (dans des formats d’heure UTC (local ou coordonné universel). Le constructeur par défaut définit l’heure sur 0.

`CFileTime::Day`

Membre de données statique qui stocke le nombre d’intervalles de 100 nanosecondes qui composent un jour.

static const ULONGLONG Day = Hour* 24;

Exemple

Consultez l’exemple pour CFileTime::Millisecond.

`CFileTime::GetCurrentTime`

Appelez cette fonction statique pour récupérer un CFileTime objet qui représente la date et l’heure système actuelles.

static CFileTime GetCurrentTime() throw();

Valeur retournée

Retourne la date et l’heure système actuelles au format UTC (Temps universel coordonné).

Exemple

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

`CFileTime::GetTime`

Appelez cette méthode pour récupérer l’heure à partir de l’objet CFileTime .

ULONGLONG GetTime() const throw();

Valeur retournée

Retourne la date et l’heure sous la forme d’un nombre 64 bits, qui peut être au format UTC (local ou coordonné).

`CFileTime::Hour`

Membre de données statiques stockant le nombre d’intervalles de 100 nanosecondes qui composent une heure.

static const ULONGLONG Hour = Minute* 60;

Exemple

Consultez l’exemple pour CFileTime::Millisecond.

`CFileTime::LocalToUTC`

Appelez cette méthode pour convertir une heure de fichier locale en heure de fichier en fonction du temps universel coordonné (UTC).

CFileTime LocalToUTC() const throw();

Valeur retournée

Retourne un CFileTime objet contenant l’heure au format UTC.

Exemple

Consultez l’exemple pour CFileTime::UTCToLocal.

`CFileTime::Millisecond`

Membre de données statiques stockant le nombre d’intervalles de 100 nanosecondes qui constituent une milliseconde.

static const ULONGLONG Millisecond = 10000;

Exemple

// 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`

Membre de données statiques stockant le nombre d’intervalles de 100 nanosecondes qui composent une minute.

static const ULONGLONG Minute = Second* 60;

Exemple

Consultez l’exemple pour CFileTime::Millisecond.

`CFileTime::operator -`

Cet opérateur est utilisé pour effectuer la soustraction sur un ou CFileTimeSpan un CFileTime objet.

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

Paramètres

span
Objet CFileTimeSpan.

ft
Objet CFileTime.

Valeur retournée

Retourne un CFileTime objet ou un CFileTimeSpan objet représentant le résultat de la différence de temps entre les deux objets.

`CFileTime::operator !=`

Cet opérateur compare deux CFileTime objets pour l’inégalité.

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

Paramètres

ft
Objet CFileTime à comparer.

Valeur retournée

Retourne TRUE si l’élément comparé n’est pas égal à l’objet CFileTime ; sinon FALSE.

`CFileTime::operator +`

Cet opérateur permet d'effectuer une addition sur un objet CFileTimeSpan.

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

Paramètres

span
Objet CFileTimeSpan.

Valeur retournée

Retourne un CFileTime objet représentant le résultat de l’heure d’origine plus une heure relative.

`CFileTime::operator +=`

Cet opérateur permet d'effectuer une addition sur un objet CFileTimeSpan et d'assigner le résultat à l'objet actuel.

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

Paramètres

span
Objet CFileTimeSpan.

Valeur retournée

Retourne l’objet mis à jour CFileTime , représentant le résultat de l’heure d’origine plus une heure relative.

`CFileTime::operator <`

Cet opérateur compare deux objets CFileTime pour déterminer le plus petit.

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

Paramètres

ft
Objet CFileTime à comparer.

Valeur retournée

Retourne TRUE si le premier objet est inférieur (plus tôt dans le temps) à la seconde, FALSE sinon.

Exemple

// 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 <>=`

Cet opérateur compare deux objets CFileTime pour déterminer le plus petit ou leur égalité.

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

Paramètres

ft
Objet CFileTime à comparer.

Valeur retournée

Retourne TRUE si le premier objet est inférieur à (antérieur dans le temps) ou égal à la seconde, sinon FALSE.

`CFileTime::operator =`

Opérateur d’assignation .

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

Paramètres

ft
Objet CFileTime contenant la nouvelle heure et la date.

Valeur retournée

Retourne l’objet mis à jour CFileTime .

`CFileTime::operator -=`

Cet opérateur est utilisé pour effectuer la soustraction sur un CFileTimeSpan objet et affecter le résultat à l’objet actuel.

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

Paramètres

span
Objet CFileTimeSpan contenant le temps relatif à soustraire.

Valeur retournée

Retourne l’objet mis à jour CFileTime .

`CFileTime::operator ==`

Cet opérateur compare deux objets CFileTime pour déterminer leur égalité.

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

Paramètres

ft
Objet CFileTime à comparer.

Valeur retournée

Retourne TRUE si les deux objets sont égaux ; sinon, FALSE.

`CFileTime::operator >`

Cet opérateur compare deux objets CFileTime pour déterminer le plus grand.

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

Paramètres

ft
Objet CFileTime à comparer.

Valeur retournée

Retourne TRUE si le premier objet est supérieur à (plus tard dans le temps) que le deuxième, sinon FALSE.

`CFileTime::operator >=`

Cet opérateur compare deux objets CFileTime pour déterminer le plus grand ou leur égalité.

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

Paramètres

ft
Objet CFileTime à comparer.

Valeur retournée

Retourne TRUE si le premier objet est supérieur (plus tard dans le temps) ou égal à la seconde, sinon FALSE.

`CFileTime::Second`

Membre de données statique qui stocke le nombre d’intervalles de 100 nanosecondes qui composent un jour.

static const ULONGLONG Second = Millisecond* 1000;

Exemple

Consultez l’exemple pour CFileTime::Millisecond.

`CFileTime::SetTime`

Appelez cette méthode pour définir la date et l’heure stockées par l’objet CFileTime .

void SetTime(ULONGLONG nTime) throw();

Paramètres

nTime
Valeur 64 bits représentant la date et l’heure, au format UTC (Temps universel local ou coordonné).

`CFileTime::UTCToLocal`

Appelez cette méthode pour convertir l’heure en temps universel coordonné (UTC) en heure de fichier locale.

CFileTime UTCToLocal() const throw();

Valeur retournée

Retourne un CFileTime objet contenant l’heure au format d’heure du fichier local.

Exemple

// 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`

Membre de données statiques stockant le nombre d’intervalles de 100 nanosecondes qui composent une semaine.

static const ULONGLONG Week = Day* 7;

Exemple

Consultez l’exemple pour CFileTime::Millisecond.

Voir aussi

FILETIME
CFileTimeSpan, classe
Graphique hiérarchique
Classes partagées ATL/MFC

Partage via

Classe CFileTime

Syntaxe

Membres

Constructeurs publics

Méthodes publiques

Opérateurs publics

Constantes publiques

Notes

Hiérarchie d’héritage

Spécifications

CFileTime::CFileTime

Paramètres

Notes

CFileTime::Day

Exemple

CFileTime::GetCurrentTime

Valeur retournée

Exemple

CFileTime::GetTime

Valeur retournée

CFileTime::Hour

Exemple

CFileTime::LocalToUTC

Valeur retournée

Exemple

CFileTime::Millisecond

Exemple

CFileTime::Minute

Exemple

CFileTime::operator -

Paramètres

Valeur retournée

CFileTime::operator !=

Paramètres

Valeur retournée

CFileTime::operator +

Paramètres

Valeur retournée

CFileTime::operator +=

Paramètres

Valeur retournée

CFileTime::operator <

Paramètres

Valeur retournée

Exemple

CFileTime::operator <>=

Paramètres

Valeur retournée

CFileTime::operator =

Paramètres

Valeur retournée

CFileTime::operator -=

Paramètres

Valeur retournée

CFileTime::operator ==

Paramètres

Valeur retournée

CFileTime::operator >

Paramètres

Valeur retournée

CFileTime::operator >=

Paramètres

Valeur retournée

CFileTime::Second

Exemple

CFileTime::SetTime

Paramètres

CFileTime::UTCToLocal

Valeur retournée

Exemple

CFileTime::Week

Exemple

Voir aussi

Commentaires

Ressources supplémentaires

Classe `CFileTime`

`CFileTime::CFileTime`

`CFileTime::Day`

`CFileTime::GetCurrentTime`

`CFileTime::GetTime`

`CFileTime::Hour`

`CFileTime::LocalToUTC`

`CFileTime::Millisecond`

`CFileTime::Minute`

`CFileTime::operator -`

`CFileTime::operator !=`

`CFileTime::operator +`

`CFileTime::operator +=`

`CFileTime::operator <`

`CFileTime::operator <>=`

`CFileTime::operator =`

`CFileTime::operator -=`

`CFileTime::operator ==`

`CFileTime::operator >`

`CFileTime::operator >=`

`CFileTime::Second`

`CFileTime::SetTime`

`CFileTime::UTCToLocal`

`CFileTime::Week`