 |
TrFile_GetTimeModified |
Returns the modification time for the file specified by the filePath. The modification time is also displayed in the Finder or Explorer.
Syntax
TrFile_GetTimeModified ( switches ; filePath )
Parameters
| switches | modifies the action of the function |
| filePath | the path to the file for which you want the information |
Switches
Switches can be empty or one of this:
| -UTC | returns the modification time in UTC (Coordinated Universal Time) |
Returned Result
Data type returned
Time
Result
The returned result is the modification time of the file. The time is in the same format as a time field (number of seconds since 00:00:00).
An error code may 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 18 to FileMaker Pro 22 (2025)
Considerations
You can use FileMaker styled paths, like “filewin:/C:/MyFiles/test.txt”.
The returned date is in the local time zone. Use -UTC to get the date in the UTC timezone (Coordinated Universal Time or GMT).
v16.0.1 added the switch -UTC
Example
Set Field [ modificationTime ; TrFile_GetTimeModified ( "C:\Test.txt" ) ]This might return the number 7265 which is equivalent to the time: 02:01:05.
Example 2
We assume that in your FileMaker file the following fields are defined:
modificationTime time
gFilePath Global, textgFilePath should contain the path to the file, for example “D:\Logs\L01.TXT” (Windows) or “Mac HD:Logs:Log 1” (Mac). In a script add the following script step:
Set Field [ modificationTime ; TrFile_GetTimeModified ( gFilePath ) ]This will store the modification time of the file specified by gFilePath in the field modificationTime.
Used in example file
DataIn.fmp12
Related functions
| TrFile_GetTimeModified |
| TrFile_SelectFileDialog |
Related topics
Troi File Plug-in online help (overview)