ssCore.FileSys.getTimeStamp

Returns the time of creation or last modification for the specified file or folder.


Availability:

First available in version 3.0 build 2039.


Input Parameters:

path - A fully qualified file or folder path path (drive letter or UNC path). This parameter supports monikers.

useUTC - [Optional] - Report the information using UTC. Valid values include: true,false. Default value is false.


Output Parameters:

result - Timestamp for the file/folder in the "YYYY/MM/DD HH:MM:SS" format.


Asynchronous Mode:

When this method is called asynchronously, a return object containing the output parameters is passed to the specified callback function.

ssCore.FileSys.getTimeStamp( paramsObject [, callbackParamsObject] [, errorParamsObject] );


Synchronous Mode:

When this method is called synchronously, a return object containing the output parameters is returned to the caller immediately.

var returnObject = ssCore.FileSys.getTimeStamp( paramsObject );


Notes:

The format for the time stamp is "YYYY/MM/DD HH:MM:SS" where the HH (hours) component is given in 24 hour format. Possible values for HH are from 00 to 23. Example "2003/06/18 15:58:15" represents June 18th 2003 at 3:58 pm.

The time stamp includes both the time and date that specifies when the file was last written to. For a directory, the structure specifies when the directory was created. If the underlying file system does not support last write time this value will specify when the file or directory was created. If the underlying file system does not support creation time, an empty string will be returned.

The timestamp is reported in local time unless specified.

                

Examples:

var return_obj = ssCore.FileSys.getTimeStamp({path:"startdir://file.txt"});

ssDebug.trace(return_obj.result);