System.SysUtils.FileAge

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function FileAge(const FileName: string): LongInt; overload;
function FileAge(const FileName: string; out FileDateTime: TDateTime; FollowLink: Boolean = True): Boolean;

C++

extern DELPHI_PACKAGE int __fastcall FileAge _DEPRECATED_ATTRIBUTE0 (const System::UnicodeString FileName)/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils


Description

Renvoie l'horodatage système d'un fichier.

Appelez FileAge pour obtenir l'horodatage système du fichier spécifié par le paramètre FileName.

La première surcharge renvoie un entier représentant l'horodatage système du fichier. Le résultat peut être converti par la suite en TDateTime biais de la fonction FileDateToDateTime.

Remarque : La première version surchargée de FileAge est obsolète. Utilisez plutôt la seconde version de FileAge.

La seconde surcharge est préférée, et renvoie l'horodatage de FileName dans le paramètre de sortie FileDateTime. Par exemple, voici la syntaxe C++ préférée :

extern DELPHI_PACKAGE bool __fastcall FileAge(const System::UnicodeString FileName, /* out */ System::TDateTime &FileDateTime, bool FollowLink = true)/* overload */;

Si le paramètre FileName est un lien symbolique et si le paramètre FollowLink est défini sur True, la méthode est exécutée sur le fichier cible. Si la première condition est True, mais que le paramètre FollowLink est défini sur False, l'horodatage du lien symbolique est renvoyé. La valeur de retour est Truesi l'opération a réussi, ou False sinon:

Exemple

Delphi :

uses
  System.SysUtils;
var
  timeDate : TDateTime;
begin
  FileAge('C:\Users\User\Desktop\aFile.xml', timeDate);
  writeln(DateTimeToStr(timeDate));
end.

C++ :

#include <System.SysUtils.hpp>
#include <stdio.h>
 
int main()
{
  TDateTime *timeDate = new TDateTime();
  UnicodeString aFile = "C:\\Users\\User\\Desktop\\aFile.xml";
  FileAge(aFile, *timeDate, true);
  printf("%ls", DateTimeToStr(*timeDate));
  return 0;
}

Voir aussi

Exemples de code