Interface

#include <codecogs/finance/banking/nperiods.h>

using namespace Finance::Banking;

	enum	PaymentPoint Enumation of Payment point
	double	nPeriods (double rate,      double pmtValue,      double presentValue,      double futureValue,      Finance::Banking::PaymentPoint type=pp_EndOfPeriod) Return the number of periods for an investment. Excel: NPER

---

Function Documentation

Calculates the number of periods for an investment based on periodic, constant payments and a constant interest rate. The function works using the following equation:

Rearranged to give: where:

• nper is the value we are trying to calculate, the number of periods,
• fv is the future value of the investment,
• pv is the present value of the investment,
• pmt is the payment made each period.

Example:

#include <iostream>
#include <codecogs/finance/banking/nperiods.h>	
	
int main(void)
{
	printf("nPeriods(0.01, -100, -1000, 10000, pp_StartOfPeriod) = %lf\n",
				 Finance::Banking::nPeriods(0.01,
				-100, -1000, 10000, Finance::Banking::pp_StartOfPeriod));
	
	printf("nPeriods(0.01, -100, -1000, 10000, pp_EndOfPeriod) = %lf\n",
				 Finance::Banking::nPeriods(0.01,
				-100, -1000, 10000, Finance::Banking::pp_EndOfPeriod));
	
	printf("nPeriods(0.01, -100, 1000, 0, pp_EndOfPeriod) = %lf\n",
				 Finance::Banking::nPeriods(0.01,
				-100, 1000, 0,	Finance::Banking::pp_EndOfPeriod));
	
	return 1;
}

Output:

nPeriods(0.01, -100, -1000, 10000, pp_StartOfPeriod) = 59.673866
nPeriods(0.01, -100, -1000, 10000, pp_EndOfPeriod) = 60.082123
nPeriods(0.01, -100, 1000, 0, pp_EndOfPeriod) = 10.588644

Parameters:

rate	The interest rate per period of the investment.
pmtValue	The payment made each period. This value must remain constant over the life of the annuity.
presentValue	The present value of the investment, or the lump-sum amount that a series of future payments is worth right now.
futureValue	The future value of the investment.
type	A value indicating whether the payment is made at the beginning or the end of each period. It is set to either: pp_EndOfPeriod or pp_StartOfPeriod.

Returns:

The number of periods of the investment.

Authors:

James Warren (August 2005)

Source Code:

- To get code register with CodeCogs. Already a Member, then Login.

---

Other Documentation

This enumerate type describes the payment points, which can either occur at the begining or end of each periond, i.e

• pp_EndOfPeriod
• pp_StartOfPeriod

Source Code:

- To get code register with CodeCogs. Already a Member, then Login.