time( )

Topic group Related topics Example

Returns the time stamp for a file, the time the file was last modified.

Syntax

<oRef>.time(<filename expC>)

<oRef>

A reference to a File object.

<filename expC>

The name of the file to check. Wildcard characters are not allowed; you must specify the actual file name.

If you specify a file without including its path, dBASE Plus looks for the file in the current directory, then in the search path(s) you specified with SET PATH, if any. If you specify a file without including its extension, dBASE Plus assumes no extension. If the named file cannot be found, an exception occurs.

Property of

File

Description

Use time( ) to determine the time of day when the last change was made to a file on disk. time( ) returns the time as a character string.

When you update a file, dBASE Plus changes the file’s time stamp to the current operating system time when the file is written to disk. For example, when the user edits a DB table, dBASE Plus changes the time stamp on the table file when the file is closed. time( ) reads the time stamp and returns its current value.

To get the time the file was created, use createTime( ). For the date the file was last modified, use date( ).