[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
SECTOTIME()
Converts seconds into a time string
------------------------------------------------------------------------------
Syntax
SECTOTIME(<nSeconds>, [<lHundredth>]) --> cTime
Arguments
<nSeconds> Designates the number of seconds since midnight to
convert into a character string in time format.
<lHundredth> If this optional parameter is designated as .T., the
resulting time string contains hundredths of seconds. The default is no
hundredths (.F.).
Returns
SECTOTIME() returns a time string that corresponds to <nSeconds> in the
"HH:MM:SS" or "HH:MM:SS:hh" format.
Description
This function can be applied in two areas -- to convert numeric time
spans in seconds, and to convert a point in time into the "HH:MM:SS" or
"HH:MM:SS:hh" format.
If hundredths of seconds are also desired in the time string result,
then designate the second parameter as .T.. The portion of the value
for <nSeconds> to the right of the decimal is also converted.
Notes
. Seconds since midnight are in the range of 0 to 86400. With
larger values, the function internally executes the operation
<nSeconds>
% 86400 and then uses the result value. 86400 seconds corresponds to
an entire day.
. There is no rounding when values like 45366.98 are converted
without hundredths.
Examples
. Calculate the span between two times. The result is displayed
in the "HH:MM:SS" format:
nBeginning := 170
nEnd := 3656
? SECTOTIME(nEnd - nBeginning) // "00:58:06"
. With hundredth seconds:
? SECTOTIME(45873.22, .T.) // "12:44:33:22"
See Also:
TIMETOSEC()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson