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


#if @HELP_HOURS2YEARS

    HOURS2YEARS

    Purpose: Converts hours to years.

    Syntax:  HOURS2YEARS(hours)

              hours - A scalar or series, the hours values.

    Returns: A scalar or series of years values.

    Example:
             hours2years(3)

             returns 0.000342, the number of years in 3 hours.

    Example:
             years2hours(hours2years(3))

             returns 3 hours showing years2hours and hours2years are inverse
             functions.

    Example:
             W1: 0..1752..8760
             W2: hours2years(w1)
             W3: years2hours(w2)

             W1 contains the hours series {0, 1752, 3504, 5256, 7008, 8760}.

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

             W3 recovers the original hours series.

    Remarks:
             HOURS2YEARS converts an hour value or series to years.

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

             See YEARS2HOURS to convert a years value or series to
             hours.

    See Also:
             HOURS2DAYS
             HOURS2MINUTES
             HOURS2SECONDS
             YEARS2HOURS
#endif


/* convert hours to years */
hours2years(hours = 0)
{
        local years;

        years = days2years(hours2days(hours));

        return(years);
}