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


#if @HELP_SECONDS2MINUTES

    SECONDS2MINUTES

    Purpose: Converts seconds to minutes.

    Syntax:  SECONDS2MINUTES(seconds)

              seconds - A scalar or series, the seconds values.


    Returns: A scalar or series of minutes values.

    Example:
             seconds2minutes(3)

             returns 0.05, the number of minutes in 3 seconds.

    Example:
             minutes2seconds(seconds2minutes(3))

             returns 3 seconds showing minutes2seconds and seconds2minutes
             are inverse functions.

    Example:
             W1: 0..12..60
             W2: seconds2minutes(w1)
             W3: minutes2seconds(w2)

             W1 contains the seconds series {0, 12, 24, 26, 48, 60}.

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

             W3 recovers the original seconds series.

    Remarks:
             SECONDS2MINUTES converts a seconds value or series to minutes.

             See MINUTES2SECONDS to convert a minutes value or series to
             seconds.

    See Also:
             SECONDS2DAYS
             SECONDS2HOURS
             SECONDS2YEARS
             MINUTES2SECONDS
#endif


/* convert seconds to minutes */
seconds2minutes(seconds = 0)
{
        local minutes;

        minutes = seconds / 60;

        if (isarray(minutes))
        {
                setvunits(minutes, "Minutes", -1);
        }

        return(minutes);
}