TrFile_GetDateModified (function reference)

By January 1, 2021January 26th, 2021Online Help, Troi File Plug-in
Troi File Plug-in > Functions reference > TrFile_GetDateModified
Troi File Plug-in for FileMaker Pro

TrFile_GetDateModified

Returns the modification date for the file specified by the filePath. The modification date is also displayed in the Finder or Explorer.

SyntaxFunction badge

TrFile_GetDateModified ( switches ; filePath )

Parameters

switches not used, reserved for future use. Leave blank or put "-Unused"
filePath the path to the file for which you want the information

Returned Result

Data type returned

Date

Result

The returned result is the modification date of the file. The date is in the same format as a date field.

An error code might also be returned. An error always starts with 2 dollars, followed by the error code. Returned error codes can be:

$$-43 fnfErr File not found, check if the path is valid
$$-1 genericErr The file could not be found (older versions of the plug-in)

Other errors may be returned.

Originated in

Troi File Plug-in 1.0

Compatibility

FileMaker Pro 16 to 19

Considerations

You can use FileMaker styled paths, like “filewin:/C:/MyFiles/test.txt”.

Example

Set Field [ modificationDate ; TrFile_GetDateModified ( "-Unused" ; "C:\Test.txt" ) ]

This may return the number 730173 which is equivalent to the date: 23 Feb. 2000.

Example 2

We assume that in your FileMaker file the following fields are defined:

  modificationDate	date
  gFilePath		Global, text

gFilePath should contain the path to the file, for example “D:\Logs\L2000_01.TXT” (Windows) or “Mac HD:Logs:Log 2000_01” (Mac). In a script add the following script step:

Set Field [ modificationDate ; TrFile_GetDateModified ( "-Unused" ; gFilePath ) ]

This will store the modification date of the file specified by gFilePath in the field modificationDate.

Used in example file

DataIn.fmp12

Related functionsFunction badge

TrFile_GetDateCreated
TrFile_GetTimestampModified
TrFile_SelectFileDialog

Related topics

Troi File Plug-in online help (overview)


Online Help Page for Troi File Plug-in for 16 to 19 –> TrFile_GetDateModified (filep4231) 2021-0125 21:16:47