Returns the future value of an investment.

Namespace: Imsl.Finance
Assembly: ImslCS (in ImslCS.dll) Version: 6.5.0.0

Syntax

C#
public static double Fv(
	double rate,
	int nper,
	double pmt,
	double pv,
	Finance..::.Period period
)
Visual Basic (Declaration)
Public Shared Function Fv ( _
	rate As Double, _
	nper As Integer, _
	pmt As Double, _
	pv As Double, _
	period As Finance..::.Period _
) As Double
Visual C++
public:
static double Fv(
	double rate, 
	int nper, 
	double pmt, 
	double pv, 
	Finance..::.Period period
)

Parameters

rate
Type: System..::.Double
A double which specifies the interest rate.
nper
Type: System..::.Int32
A int which specifies the total number of payment periods.
pmt
Type: System..::.Double
A double which specifies the payment made in each period.
pv
Type: System..::.Double
A double which specifies the present value.
period
Type: Imsl.Finance..::.Finance..::.Period
A int which specifies the time in each period when the payment is made (either AtEnd or AtBeginning).

Return Value

A double which specifies the future value of an investment.

Remarks

The future value is the value, at some time in the future, of a current amount and a stream of payments. It can be found by solving the following:

If rate = 0,

{\it pv} + {\it pmt} \times {\it nper} + {\it fv} = 0

If rate \ne 0,

{\it pv} (1 + {\it rate})^{\it nper} + {\it pmt} \left[ {1 + {\it rate} \left( {\it period} \right)} \right] {{(1 + {\it rate})^{\it nper} - 1} \over {\it rate}} + {\it fv} = 0

See Also