MAINSAIL Language Manual, Section 48.9

previous   next   top   contents   index   framed top   this page unframed


48.9. $time

Figure 48–8. $time
LONG INTEGER
PROCEDURE   $time       (OPTIONAL BITS ctrlBits);

$time returns the current time of day.

The valid predefined BITS constants for ctrlBits are $localTime, $gmt, and errorOK.

If $localTime is specified (or if neither $localTime nor $gmt is specified), the local time is returned, if available. If $gmt is specified, the GMT time is returned, if available.

If the predefined BITS constant errorOK is specified and the time is not provided by the operating system, 0L is returned. If errorOK is not specified, the user is prompted for the time if it is not provided by the operating system.

$dateAndTime should be used if both date and time are to be obtained for the same instant. Otherwise, a wraparound can occur at midnight.

The standard MAINSAIL date and time formats are described in Section 24.1.


previous   next   top   contents   index   framed top   this page unframed

MAINSAIL Language Manual, Section 48.9