• *add_days Function
• *add_hours Function
• *add_minutes Function
• *add_months Function
• *add_seconds Function
• *add_years Function
• *days_between Function
• *hours_between Function
• *minutes_between Function
• *months_between Function
• *seconds_between Function
• *years_between Function
• a5_add_timestamp Function
• A5_CONVERT_DATE_STRING Function
• A5_CONVERT_DATETIME_STRING Function
• a5_embeddedcalendargenie Function
• a5_get_date_format Function
• A5_GETDATEHTML Function
• a5_gettimeformats Function
• a5_gettimevalue Function
• a5_normalizedate Function
• A5_RFC1123DATE Function
• A5_RFC822DATE Function
• A5_RFC850DATE Function
• A5_T_FROM_RFCDATE Function
• a5_time_format_help Function
• A5_TIMESTAMP Function
• ADD_BUS_DAYS Function
• ADDMONTHS Function
• ADDYEARS Function
• AGE Function
• BUS_DAYS_BETWEEN Function
• CDATE Function
• CDOW Function
• CMONTH Function
• CONVERT_TYPE Function
• CShortTime Function
• CTIME Function
• CTOD Function
• CTODT Function
• CTOT Function
• CYEAR Function
• Date and Time Conversion Matrix
• Date and Time Format Elements
• Date and Time Functions
• DATE Function
• Date_FirstDayOfMonth Function
• Date_FirstDayOfPreviousMonth Function
• DATE_FORMAT Function
• DATE_FORMATS_BUILT_IN Function
• date_from_utc_date Function
• date_is_anniversary Function
• date_is_in_last_month Function
• DATE_IS_IN_MONTH Function
• date_is_in_previous_quarter Function
• date_is_in_previous_week Function
• date_is_in_previous_year Function
• date_is_in_same_week Function
• date_is_in_this_month Function
• date_is_in_this_month_todate Function
• date_is_in_this_quarter Function
• date_is_in_this_quarter_todate Function
• date_is_in_this_week Function
• date_is_in_this_week_todate Function
• date_is_in_this_year Function
• date_is_in_this_year_todate Function
• date_is_today Function
• date_is_yesterday Function
• Date_LastDayOfMonth Function
• Date_LastDayOfPreviousMonth Function
• date_quarternumber Function
• date_quarterstartend Function
• date_to_utc_date Function
• DATE_VALUE Function
• DAY Function
• DAY_NUMBER Function
• DMY Function
• DOW Function
• DOW_ISO Function
• DTOC Function
• DTOS Function
• FixDateString Function
• FORMAT_DATA Function
• GetTimeZoneOffset Function
• GMT Function
• Holidays
• httpdate Function
• international_days_of_week Function
• international_months Function
• JDATE Function
• JTODATE Function
• MDY Function
• MONTH Function
• MONTH_END Function
• MONTH_NUMBER Function
• MONTH_START Function
• NOW Function
• NTH_DOW Function
• ODBC_DT_TO_D Function
• Predefined Date Formats
• ProgressTimed Function
• SCANTIME Function
• ShortTime_Extract Function
• STOD Function
• Time and Date Functions
• TIME Function
• time_gmt_to_local Function
• time_to_unixtimestamp Function
• TIME_VAR Function
• timez Function
• TOSECONDS Function
• TOTIME Function
• TZ_OFFSET_TO_C Function
• unixtimestamp_to_time Function
• WEEK Function
• WEEK_ISO Function
• WEEK_ISO_FULL Function
• WIN_TIME Function
• WMI_DATE_TO_TIME Function
• wmi_datetime_to_time Function
• YEAR Function
• YearStart_ISO Function

TOTIME Function

Syntax

Arguments

secondsNumeric

The number of seconds past midnight.

format_codeNumeric

One of the following formats.

Format Parameter Value

Format

0

ss

1

hh:mm

2

hh:mm:ss

3

ddd:hh:mm:ss

11

hh:mm AM/PM

12

hh:mm:ss AM/PM

13

ddd:hh:mm:ss AM/PM

decimal_placesNumeric

The number of decimal places for seconds. The integer value can be from 0 to 3.

Returns

Formatted_Short_TimeCharacter

Returns the formatted time value.

Description

Converts a time value to a formatted time character string.

Discussion

TOTIME() returns a formatted character string containing a time based on the specified number of seconds past midnight. The resulting formatted string can be in one of seven formats specified by the format code, and can contain up to three decimal places for seconds.

Example

? totime(125, 2, 0) 
= "0:02:05"

? totime(863.5, 12, 1)
= "0:14:23.5 AM"

You may often need to compute an event's ending time, given the event's start time and duration. For example, assume that an event's start time is stored in START and the event duration (expressed as hh:mm) is stored in DURATION. You can use the following expression to return the time that the event ended:

totime((toseconds(START) + toseconds(DURATION), 1, 0)

If you have imported a time value from Microsoft Excel as a character or numeric value and you wish to convert it to a Short Time value, the following expressions will do the job.

dim dat as C
dat = .345
? totime((val(dat) * 86400),1,0)
= "8:17"

dim dat2 as N
dat2 = .345
? totime(dat2 * 86400,1,0)
= "8:17"

See Also

• Date and Time Format Elements
• Date and Time Functions