[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index]

Reference for unit 'sysutils' (#rtl)

FileAge

Return the timestamp of a file.

Declaration

Source position: filutilh.inc line 122

function FileAge(

const FileName: UnicodeString

):LongInt; function FileAge(

const FileName: UnicodeString;

out FileDateTime: TDateTime;

FollowLink: Boolean = True

):Boolean; function FileAge(

const FileName: RawByteString;

out FileDateTime: TDateTime;

FollowLink: Boolean = True

):Boolean; function FileAge(

const FileName: RawByteString

):LongInt;

Description

FileAge returns the last modification time of file FileName. The FileDate format can be transformed to TDateTime format with the FileDateToDateTime function.

Fileage cannot be used on directories, it will return -1 if FileName indicates a directory.

Errors

In case of errors, -1 is returned.

Example

Program Example36;

{ This program demonstrates the FileAge function }

Uses sysutils;

Var S : TDateTime;
    fa : Longint;
Begin
  fa:=FileAge('ex36.pp');
  If Fa<>-1 then
    begin
    S:=FileDateTodateTime(fa);
    Writeln ('I''m from ',DateTimeToStr(S))
    end;
End.

FileDateToDateTime		Convert a `FileDate` value to a `TDateTime` value.
FileExists		Check whether a particular file exists in the filesystem.
FileGetAttr		Return attributes of a file.

FileAge

Declaration

Description

Errors

See also

Example