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


#if @HELP_MINUTES2HOURS

    MINUTES2HOURS

    Purpose: Converts minutes to hours.

    Syntax:  MINUTES2HOURS(minutes)

              minutes - A scalar or series, the minutes values.


    Returns: A scalar or series of hours values.

    Example:
             minutes2hours(3)

             returns 0.05, the number of hours in 3 minutes.

    Example:
             hours2minutes(minutes2hours(3))

             returns 3 minutes showing hours2minutes and minutes2hours
             are inverse functions.

    Example:
             W1: 0..12..60
             W2: minutes2hours(w1)
             W3: hours2minutes(w2)

             W1 contains the minutes series {0, 12, 24, 36, 48, 60}.

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

             W3 recovers the original minutes series.

    Remarks:
             MINUTES2HOURS converts a minute value or series to hours.

             See HOURS2MINUTES to convert a hours value or series to
             minutes.

    See Also:
             MINUTES2DAYS
             MINUTES2SECONDS
             MINUTES2YEARS
             HOURS2MINUTES
#endif


/* convert minutes to hours */
minutes2hours(minutes = 0)
{
        local hours;

        hours = minutes / 60;

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

        return(hours);
}