Returns the cumulative principal paid between two periods.

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

Syntax

C#
public static double Cumprinc(
	double rate,
	int nper,
	double pv,
	int firstPeriod,
	int lastPeriod,
	Finance..::.Period time
)
Visual Basic (Declaration)
Public Shared Function Cumprinc ( _
	rate As Double, _
	nper As Integer, _
	pv As Double, _
	firstPeriod As Integer, _
	lastPeriod As Integer, _
	time As Finance..::.Period _
) As Double
Visual C++
public:
static double Cumprinc(
	double rate, 
	int nper, 
	double pv, 
	int firstPeriod, 
	int lastPeriod, 
	Finance..::.Period time
)

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.
pv
Type: System..::.Double
A double which specifies the present value.
firstPeriod
Type: System..::.Int32
A int which specifies the first period in the calculation. Periods are numbered starting with one.
lastPeriod
Type: System..::.Int32
A int which specifies the last period in the calculation.
time
Type: Imsl.Finance..::.Finance..::.Period
The time of a Period when the payment is made (either AtEnd or AtBeginning).

Return Value

A double which specifies the cumulative principal paid between the first period and the last period.

Remarks

It is computed using the following:

\sum\limits_{i = {\it firstPeriod}}^{\it lastPeriod} {\it principal}_i

where {\it principal}_i is computed from Ppmt for the i-th period.

See Also