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.

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

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.

Financial functions are currently unavailable in Polaris. Learn more about the differences between Anaplan calculation engines.

In the Classic Engine, if you use a timing argument, and it's value is neither 0 nor 1, the formula is not calculated correctly.

In Polaris, if you do this, the formula calculates as expected.

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.

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

CUMPRINC

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