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
| Argument | Data type | Description |
| 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) | Number | The number of periods that the Loan balance is paid over. |
| Loan balance (required) | Number | The total amount to be paid between the Start period and End period. |
| Start period (required) | Number | The period to start calculating the principal paid from. |
| End period (required) | Number | The period to stop calculating the principal paid at. |
| Timing | Number | 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:
|
The CUMPRINC function returns a number, which is the amount of principal paid for the loan.
Calculation engine functionality differences
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.
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
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 1 | Scenario 2 | Scenario 3 | Scenario 4 | Scenario 5 | Scenario 6 | |
| Interest rate | 2.5% | 2.5% | 2.5% | 2.5% | 2.5% | 2.5% |
| Number of periods | 30 | 30 | 30 | 30 | 30 | 30 |
| Loan balance | 300,000 | 300,000 | 300,000 | 300,000 | 300,000 | 300,000 |
| Start period | 1 | 1 | 30 | 1 | 15 | 1 |
| End period | 1 | 1 | 30 | 15 | 30 | 30 |
| Timing | 0 | 1 | 0 | 0 | 0 | 0 |
Cumulative principal paid
| -6,833.29 | -13,983.70 | -13,983.70 | -122,534.09 | -187,121.17 | -300,000 |
