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


#if @HELP_MINUTES2YEARS

    MINUTES2YEARS

    Purpose: Converts minutes to years.

    Syntax:  MINUTES2YEARS(minutes)

              minutes - A scalar or series, the minutes values.


    Returns: A scalar or series of years values.

    Example:
             minutes2years(3)

             returns 0.000005708, the number of years in 3 minutes.

    Example:
             years2minutes(minutes2years(3))

             returns 3 minutes showing years2minutes and minutes2years
             are inverse functions.

    Example:
             W1: 0..105120..525600
             W2: minutes2years(w1)
             W3: years2minutes(w2)

             W1 contains the minutes series:

             {0, 105120, 210240, 315360, 420480, 525600}

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

             W3 recovers the original minutes series.

    Remarks:
             MINUTES2YEARS converts a minute value or series to years.

             MINUTES2YEARS assumes that a leap year can occur four years after
             the first full year.

             See YEARS2MINUTES to convert a years value or series to minutes.

    See Also:
             MINUTES2DAYS
             MINUTES2HOURS
             MINUTES2SECONDS
             YEARS2MINUTES
#endif


/* convert minutes to years */
minutes2years(minutes = 0)
{
        local years;

        years = days2years(minutes2days(minutes));

        if (isarray(years))
        {
                setvunits(years, "Years", -1);
        }

        return(years);
}