1. Calculation functions
2. All functions
3. Financial functions
4. CUMPRINC

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: 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.

### 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

CUMPRINC

## 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 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 may update our documentation occasionally, but will only do so in a way that does not negatively affect the features and functionality of the Anaplan service.