The CUMPRINC function calculates the amount of principal paid on a loan over a period, given consistent, equal payments.

For example, you can use the CUMPRINC function to calculate the remaining balance on a mortgage.

Syntax

CUMPRINC(Interest rate, Number of periods, Loan balance, Start period, End period [, Timing])

Arguments

ArgumentData typeDescription
Interest rate (required)Number

The interest rate of the loan.

This argument is best used with the Percent format, as 0.1 equals 10%, and so on.

Number of periods (required)NumberThe number of periods that the Loan balance is paid over.
Loan balance (required)NumberThe total amount to be paid between the Start period and End period.
Start period (required)NumberThe period to start calculating the principal paid from.
End period (required)NumberThe period to stop calculating the principal paid at.
TimingNumber

Whether payments are made at the start or end of each period.

If a payment is made at the start of the period, that period's interest applies to it.

You can enter a value of 0 or 1 for this argument. If you enter:

  • 0, payments are made at the end of each period (the default if this argument is omitted)
  • 1, payments are made at the start of each period

The CUMPRINC function returns a number, which is the amount of principal paid for the loan.

Additional information

Periods used with the CUMPRINC function

The Number of periods argument enables you to specify the number of periods the loan is paid over. The Start period and End period arguments enable you to specify what range of periods to calculate the cumulative interest for.

The value you provide for the Interest rate argument must match the Number of periods arguments. For example, if the periods are years, you should provide the annual interest rate.

Positive and negative values

For any values you give the CUMPRINC function via an argument, or that the function returns:

  • a positive value represents money you receive, such as a dividend or loan
  • a negative value represents money paid, such as a deposit or interest payment

Excel equivalent

CUMPRINC

Related Anaplan functions

Examples

In this example, there's a Scenarios list on columns, and line items on rows. There's one line item for each argument of the CUMPRINC function.

Each item in the Scenario list uses the same value for the Interest rate, Number of periods, and Loan Balance arguments. However, they use different values for the Start period and End period arguments. This highlights how the cumulative principal paid changes in different periods over the duration of a loan.


Scenario 1Scenario 2Scenario 3Scenario 4Scenario 5Scenario 6
Interest rate2.5%2.5%2.5%2.5%2.5%2.5%
Number of periods303030303030
Loan balance300,000300,000300,000300,000300,000300,000
Start period11301151
End period1130153030
Timing010000

Cumulative principal paid

CUMPRINC(Interest rate, Number of periods, Loan balance, Start period, End period, Timing)

-6,833.29-13,983.70-13,983.70-122,534.09-187,121.17-300,000

Disclaimer

We update Anapedia regularly to provide the most up-to-date instructions.