The AnnuityFutureValue built-in Glb.Financial method calculates the annuity (regular savings) required to accumulate the nominated future value.
The following calculation is used:
Refer to Glb.Financial Built-In Methods for more information on designations used in this calculation.
Failure behavior
The AnnuityFutureValue method can return an inconsistent result if an error occurs. The Glb.Status built-in segment attribute should be verified before the result is used.
If assigning the result to a signed number-primitive variable, truncation of significant digits occurs without warning if it is not of a sufficient length.
Syntax
Glb.Financial::AnnuityFutureValue( futureValue : numericExpression, interestRate : numericExpression, timeUnits : numericExpression) : numericLiteral
Owner
Glb.Financial.
Return type
A numeric literal, length and decimal properties of which can vary. As a guideline, the internal intermediate work files are stored as USAGE COMP-2, and rounded on output.
Parameters
futureValue
A numeric expression specifying the future value, Sn. This expression is assumed to be of length 12, with 3 decimal places. If this expression that does not have these property values, it should be ensured that truncation of significant digits does not occur.
interestRate
A numeric expression specifying the interest rate percentage, i, to be applied per time unit. This expression is assumed to be of length 10, with 8 decimal places. It must be positive and is interpreted as a percentage.
timeUnits
A numeric expression specifying the number of time units, N. This expression is assumed to be of length 12, with 6 decimal places.