HMS2TIME

Purpose:

Converts hours, minutes and seconds values to time values.

Syntax:

HMS2TIME(hours, minutes, seconds)

Returns:

A series or array of time of day values.

Example:

W1: hms2time(12, 0, 0)

W1 contains the time 12:00:00 with the equivalent time of day value of 43200 seconds.

Example:

W1: {11, 12, 13}

W2: {15, 30, 45}

W3: {10, 20, 30}

W4: hms2time(w1, w2, w3)

W1 contains the hours values.

W2 contains the minutes values.

W3 contains the seconds values.

W4 contains the time series:

11:15:10

12:30:20

13:45:30

Example:

W1: hms2time(11..13, {15, 30, 45}, {10, 20, 30})

Same as above except the hour, minutes and seconds values are entered directly as series.

W1 contains the time series:

11:15:10

12:30:20

13:45:30

Example:

W1: hms2time(11..13, {15, 30, 45}, {10, 20, 70})

Same as above except the last seconds value of 70 causes the resulting minutes to rollover.

W1 contains the time series:

11:15:10

12:30:20

13:46:10

Remarks:

HMS2TIME creates a time series by combining individual hour, minutes and seconds values.

Out of range minutes and seconds values are rolled over.

A time of day, or TOD, value is the number of seconds since midnight.

See Also:

TIME2HMS

TODMSECSTR

TODSTR

YMD2DATE

YMDHMS2DT