Function Reference


Returns the time and date information for a file.

FileGetTime ( "filename" [, option = 0 [, format = 0]] )


filename The path to the file or directory to check.
option [optional] Flag to indicate which timestamp
    $FT_MODIFIED (0) = Last modified (default)
    $FT_CREATED (1) = Created
    $FT_ACCESSED (2) = Last accessed

Constants are defined in FileConstants.au3
format [optional] to specify type of return
    $FT_ARRAY (0) = return an array (default)
    $FT_STRING (1) = return a string YYYYMMDDHHMMSS

Constants are defined in FileConstants.au3

Return Value

Success: an array or string that contains the file time information. See Remarks.
Failure: sets the @error flag to non-zero.


The array is a single dimension array containing six elements:
    $aArray[0] = year (four digits)
    $aArray[1] = month (range 01 - 12)
    $aArray[2] = day (range 01 - 31)
    $aArray[3] = hour (range 00 - 23)
    $aArray[4] = min (range 00 - 59)
    $aArray[5] = sec (range 00 - 59)
Notice that return values are zero-padded.


FileGetAttrib, FileGetSize, FileGetVersion, FileSetAttrib, FileSetTime


#include <FileConstants.au3>
#include <MsgBoxConstants.au3>
#include <WinAPIFiles.au3>


Func Example()
    ; Create a constant variable in Local scope of the filepath that will be read/written to.
    Local Const $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; Set the modified timestamp of the file to 1st Nov 2003 and use the current time.
    Local $iFileSetTime = FileSetTime($sFilePath, "20031101", $FT_MODIFIED)

    ; Display the modified timestamp of the file and return as a string in the format YYYYMMDDHHMMSS.
    If $iFileSetTime Then
        MsgBox($MB_SYSTEMMODAL, "", "Timestamp:" & @CRLF & FileGetTime($sFilePath, $FT_MODIFIED, 1))
        MsgBox($MB_SYSTEMMODAL, "", "An error occurred whilst setting the timestamp of the file.")

    ; Delete the temporary file.
EndFunc   ;==>Example