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


#if @HELP_SECONDS2YEARS

    SECONDS2YEARS

    Purpose: Converts seconds to years.

    Syntax:  SECONDS2YEARS(seconds)

              seconds - A scalar or series, the seconds values.


    Returns: A scalar or series of years values.

    Example:
             seconds2years(3)

             returns 0.000000095, the number of years in 3 seconds.

    Example:
             years2seconds(seconds2years(3))

             returns 3 seconds showing years2seconds and seconds2years
             are inverse functions.

    Example:
             W1: 0..6307200..31536000
             W2: seconds2years(w1)
             W3: years2seconds(w2)

             W1 contains the seconds series:

             {0, 6307200, 12614400, 18921600, 25228800, 31536000}

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

             W3 recovers the original seconds series.

    Remarks:
             SECONDS2YEARS converts a seconds value or series to years.

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

             See YEARS2SECONDS to convert a years value or series to seconds.

    See Also:
             SECONDS2DAYS
             SECONDS2HOURS
             SECONDS2SECONDS
             YEARS2SECONDS
#endif


/* convert seconds to years */
seconds2years(seconds = 0)
{
        local years;

        years = days2years(seconds2days(seconds));

        return(years);
}