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"

Seealso

TIMETOSEC()