CFLib.org – Common Function Library Project

Description:
Returns the date/time a folder (directory) was created. Because this function uses COM, it is only supported in the Windows version of ColdFusion.

Return Values:
Returns a date/time object.

Example:

<CFSET TheFolder = "c:\winnt">
<CFOUTPUT>
The #TheFolder# folder was created on #DateFormat(FolderDateCreated(TheFolder), 'mm/dd/yyyy')# at #TimeFormat(FolderDateCreated(TheFolder), 'HH:MM:SS')#.
</CFOUTPUT>

Parameters:

Full UDF Source:

/**
 * Returns the date/time a folder (directory) was created. (Windows only)
 * 
 * @param path      Absolute or relative path to the specified folder. 
 * @return Returns a date/time object. 
 * @author Rob Brooks-Bilson (rbils@amkor.com) 
 * @version 1.0, July 20, 2001 
 */
function FolderDateCreated(path)
{
  Var fso  = CreateObject("COM", "Scripting.FileSystemObject");
  Var folder = fso.GetFolder(path);
  Return folder.DateCreated;
}