FileGetTime

Retrieves the datetime stamp of a file or folder.

Timestamp := FileGetTime(Filename, WhichTime)

Parameters

Filename

Type: String

If omitted, the current file of the innermost enclosing file loop will be used. Otherwise, specify the name of the target file or folder, which is assumed to be in A_WorkingDir if an absolute path isn't specified.

WhichTime

Type: String

If blank or omitted, it defaults to M. Otherwise, specify one of the following letters to set which timestamp should be retrieved:

Return Value

Type: String

This function returns a string of digits in the YYYYMMDDHH24MISS format. The time is your own local time, not UTC/GMT. This string should not be treated as a number, i.e. one should not perform math on it or compare it numerically.

Error Handling

An OSError is thrown on failure.

A_LastError is set to the result of the operating system's GetLastError() function.

Remarks

See YYYYMMDDHH24MISS for an explanation of dates and times.

FileSetTime, FormatTime, FileGetAttrib, FileSetAttrib, FileGetSize, FileGetVersion, file loop, DateAdd, DateDiff

Examples

Retrieves the modification time and stores it in Timestamp.

Timestamp := FileGetTime("C:\My Documents\test.doc")

Retrieves the creation time and stores it in Timestamp.

Timestamp := FileGetTime("C:\My Documents\test.doc", "C")