clock.timeStamp

Syntax clock.timeStamp ()

Params None required

Action Places into the target window a time stamp with the current date and time and user initials.

Returns True if the target window is capable of being time-stamped, false otherwise.

Examples clock.timeStamp ()

   » true

The string "Fri, Sep 6, 1991 at 12:03:44 PM by DGS" appears in the target window.

Errors Using clock.timeStamp with no target window returns false but does not generate an error message.

Notes In an outline, the time stamp is placed as a comment line (preceded by a chevron) on the line immediately following the line on which the cursor is positioned in the window. In a table, UserTalk creates a new entry called Stamped Time if one does not yet exist. It then inserts the timestamp as that cell's value.

In Frontier 7, a new pref was added, user.prefs.flShortTimeStamp, which when true results in a shorter timestamp of the form "2/1/01; 3:57:05 PM by PBS." The default is false, the traditional longer timestamp.

See Also target.set

Discuss