CUMPRINC function

Description

Returns the cumulative principal paid on a loan between start_period and end_period.

Syntax

CUMPRINC(rate, nper, pv, start_period, end_period, type)

The CUMPRINC function syntax has the following arguments:

• Rate    Required. The interest rate.

• Nper    Required. The total number of payment periods.

• Pv    Required. The present value.

• Start_period    Required. The first period in the calculation. Payment periods are numbered beginning with 1.

• End_period    Required. The last period in the calculation.

• Type    Required. The timing of the payment.

Remarks

• Make sure that you are consistent about the units you use for specifying rate and nper. If you make monthly payments on a four-year loan at an annual interest rate of 12 percent, use 12%/12 for rate and 4*12 for nper. If you make annual payments on the same loan, use 12% for rate and 4 for nper.

• If rate ≤ 0, nper ≤ 0, or pv ≤ 0, CUMPRINC returns the #NUM! error value.

• If start_period < 1, end_period < 1, or start_period > end_period, CUMPRINC returns the #NUM! error value.

• If type is any number other than 0 or 1, CUMPRINC returns the #NUM! error value.

Example

Copy the example data in the following table, and paste it in cell A1 of a new Excel worksheet. For formulas to show results, select them, press F2, and then press Enter. If you need to, you can adjust the column widths to see all the data.