/*****************************************************************************
*                                                                            *
*   SECONDS2HOURS.SPL Copyright (C) 2024 DSP Development Corporation         *
*                               All Rights Reserved                          *
*                                                                            *
*   Author:        Randy Race                                                *
*                                                                            *
*   Synopsis:      Converts seconds to hours                                 *
*                                                                            *
*   Revisions:      2 Dec 2024  RRR  Creation                                *
*                                                                            *
*****************************************************************************/


#if @HELP_SECONDS2HOURS

    SECONDS2HOURS

    Purpose: Converts seconds to hours.

    Syntax:  SECONDS2HOURS(seconds)

              seconds - A scalar or series, the seconds values.


    Returns: A scalar or series of hours values.

    Example:
             seconds2hours(3)

             returns 0.000833333, the number of hours in 3 seconds.

    Example:
             hours2seconds(seconds2hours(3))

             returns 3 seconds showing hours2seconds and seconds2hours
             are inverse functions.

    Example:
             W1: 0..720..3600
             W2: seconds2hours(w1)
             W3: hours2seconds(w2)

             W1 contains the seconds series {0, 720, 1440, 2160, 2880, 3600}.

             W2 contains the hours series {0, 0.2, 0.4, 0.6, 0.8, 1.0}.

             W3 recovers the original seconds series.

    Remarks:
             SECONDS2HOURS converts a seconds value or series to hours.

             See HOURS2SECONDS to convert a hours value or series to seconds.

    See Also:
             SECONDS2DAYS
             SECONDS2MINUTES
             SECONDS2YEARS
             HOURS2SECONDS
#endif


/* convert seconds to hours */
seconds2hours(seconds = 0)
{
        local hours;

        hours = seconds / 3600;

        if (isarray(hours))
        {
                setvunits(hours, "Hours", -1);
        }

        return(hours);
}