Financial
All versions
◉ 10 views
=CUMPRINC()
Returns the cumulative principal paid on a loan between start_period and end_period.
Applies To:
Excel for Microsoft 365Excel for Microsoft 365 for MacExcel 2024Excel 2024 for MacExcel 2021Excel 2021 for MacExcel 2019Excel 2016
=CUMPRINC(rate, nper, pv, start_period, end_period, type)
Hover argument names in the table for details.
Output typeNumber
Popularity30 / 100
VolatileNo
Dynamic ArrayNo
📥 Download sample .xlsx — Coming soon
▦ Try in Playground
Dedicated file for this function — safe & lightweight · sample data + live formulas
⬇ Download Sample Workbook
A dedicated .xlsx for =CUMPRINC() with Persian sample data & live formulas — open in Excel and practice.
- Sheet “Sample” — data table + formula in place
- Sheet “Guide” — syntax, arguments & tips from this page
- Instant & secure (token + rate limit)
🧠 🧠 Quiz this function
%d questions — syntax, example & errors — test yourself!
◧ Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
rate |
Number | Required | The interest rate. |
nper |
Number | Required | The total number of payment periods. |
pv |
Number | Required | The present value. |
start_period |
Number | Required | The first period in the calculation. Payment periods are numbered beginning with 1. |
end_period |
Number | Required | The last period in the calculation. |
type |
Number | Required | The timing of the payment. 0 (zero) = Payment at the end of the period; 1 = Payment at the beginning of the period. |
▣ Examples
▦ Data
| Cell | Value | Description |
|---|---|---|
A2 |
0.09 | Interest rate per annum |
A3 |
30 | Term in years |
A4 |
125000 | Present value |
A5 |
0.09 | Interest rate per annum |
A6 |
30 | Term in years |
A7 |
125000 | Present value |
The total principal paid in the second year of payments, periods 13 through 24
=CUMPRINC(A2/12,A3*12,A4,13,24,0)
Result:
-934.1071234
The principal paid in a single payment in the first month (-68.27827)
=CUMPRINC(A2/12,A3*12,A4,1,1,0)
Result:
-68.27827118
§ 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.
✦ Tips
- 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.
⚠ Common Errors
#NUM!
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.
Fix: Check the inputs and the order of the start and end payments
💬 Comments & Q&A 0 approved
🔒 Your comment will be published after review.Share your thoughts — visible after admin approval
No comments yet — be the first!