Classe CFileTime
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 |
| Seconde | Milliseconde * 1 000 |
| Minute | Deuxième * 60 |
| Heure | Minute * 60 |
| Jour | Heure * 24 |
| Semaine | 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
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour