FV
function FV(
arg1: number = null,
arg2: number = null,
arg3: number = null,
arg4: number = null,
arg5: number = null,
): number | string | boolean
Description
Returns the future value of an investment based on periodic, constant payments and a constant interest rate.
Parameters
- arg1
number
null Is the interest rate per period. For example, use 6%/4 for quarterly payments at 6% APR.
- arg2
number
null Is the total number of payment periods in the investment.
- arg3
number
null Is the payment made each period; it cannot change over the life of the investment.
- arg4
number
null Is the present value, or the lump-sum amount that a series of future payments is worth now. If omitted, Pv = 0.
- arg5
number
null Is a value representing the timing of payment: payment at the beginning of the period = 1; payment at the end of the period = 0 or omitted.
Returns
number | string | boolean
Try It
var oWorksheet = Api.GetActiveSheet();
var oFunction = Api.GetWorksheetFunction();
oWorksheet.GetRange("A1").SetValue(oFunction.FV(0.1/12, 2*12, -500, 10000));