CFLib.org – Common Function Library Project

FileDateLastAccessed(path)

Last updated July 24, 2001

author

Rob Brooks-Bilson

Version: 1 | Requires: CF5 | Library: FileSysLib

Description:
Returns the date/time a file was last accessed. Because this function uses COM, it is only supported in the Windows version of ColdFusion.

Return Values:
Returns a date/time object.

Example:

<CFSET TheFile = "c:\winnt\notepad.exe">
<CFOUTPUT>
The #TheFile# file was last accessed on #DateFormat(FileDateLastAccessed(TheFile), 'mm/dd/yyyy')# at #TimeFormat(FileDateLastAccessed(TheFile), 'HH:MM:SS')#.
</CFOUTPUT>

Parameters:

Name Description Required
path Absolute or relative path to the specified file. Yes

Full UDF Source:

/**
 * Returns the date/time a file was last accessed. (Windows only)
 * 
 * @param path 	 Absolute or relative path to the specified file. 
 * @return Returns a date/time object. 
 * @author Rob Brooks-Bilson (rbils@amkor.com) 
 * @version 1.0, July 24, 2001 
 */
function FileDateLastAccessed(path)
{
  Var fso  = CreateObject("COM", "Scripting.FileSystemObject");
  Var theFile = fso.GetFile(path);
  Return theFile.DateLastAccessed;
}
blog comments powered by Disqus

Search CFLib.org


Latest Additions

Kevin Cotton added
date2ExcelDate
May 5, 2016

Raymond Camden added
CapFirst
April 25, 2016

Chris Wigginton added
loremIpsum
January 18, 2016

Gary Stanton added
calculateArrival...
November 19, 2015

Sebastiaan Naafs - van Dijk added
getDaysInQuarter
November 13, 2015

Created by Raymond Camden / Design by Justin Johnson