Time Details

Modifying Action Diagrams › Understanding Built-In Functions › Considerations for Date and Time Field Types › Time Details

Time Details

The *TIME DETAILS built-in function returns information about a given time. You specify the type of information you need using the *Time Detail parameter.

There are three parameters for this function type:

Two input parameters
- *Time is the time for which information is to be returned. If it is of type NBR, it is interpreted as the elapsed time since 0 am.
- *Time detail type determines the meaning of the output parameter, *Time detail.
One output parameter, *Time detail, returns the requested information for the specified time.

The possible values for the *Time detail type parameter and the effect of each on the meaning of the result are summarized in the following table.

*Time Detail Type Values	Effect on the *Time Detail Parameter
*SECONDS	An integer from 0 to 59 specifying the number of seconds in the specified time (*Time).
*ELAPSED SECONDS	An integer containing the number of elapsed seconds since 0 am for the given time (*Time).
*MINUTES	An integer from 0 to 59 specifying the number of minutes in the specified time (*Time).
*ELAPSED MINUTES	An integer specifying the number of elapsed minutes since 0 am for the specified time (*Time).
*HOURS	An integer from 0 to 23 specifying the number of hours in the specified time (*Time).
*HHMM	The number of hours and minutes represented by the given time (*Time) in HHMM format.
*HHMMSS	The number of hours, minutes, and seconds represented by the given time (*Time) in HHMMSS format.
*PM?	An integer that indicates whether the given time is am or pm. The possible values are 1=pm and 0=am.