xHarbour Reference Documentation > Function Reference

Fv()

Calculates the future value of constant, periodic investments.

Syntax

Fv( <nInvestment>   , ;
    <nInterestRate> , ;
    <nPeriods>        ) --> nFutureValue

Arguments

<nInvestment>

A numeric value defining the constant, periodic investment.

<nInterestRate>

This parameter defines a constant interest rate per period during the periods of the investment in the range of 0 to 1 (1 equals 100% interest rate).

<nPeriods>

This is a numeric value defining the number of periods to include in the calculation.

Return

The function returns the future value of a periodic, constant investments at a constant interest rate over a period of time as a numeric value.

Info

See also:	Payment(), Periods(), Pv(), Rate()
Category:	CT:Math , Financial functions , Mathematical functions
Source:	ct\finan.c
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// The example calculates the future value of a monthly investment
// of 100 units of money over a period of 66 months at a savings
// interest rate of 4% per year.

   PROCEDURE Main
      LOCAL nInvestment := 100        // monthly payment
      LOCAL nInterest   := 0.04/12    // monthly interest rate
      LOCAL nMonths     := 66         // total investment period

      ? FV( nInvestment, nInterest, nMonths )  // result: 7368.63

   RETURN