System.SysUtils.FileAge
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;
}