WorksheetFunction.Ipmt method (Excel)
Returns the interest payment for a given period for an investment based on periodic, constant payments and a constant interest rate.
Syntax
expression.Ipmt (Arg1, Arg2, Arg3, Arg4, Arg5, Arg6)
expression A variable that represents a WorksheetFunction object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| Arg1 | Required | Double | Rate - the interest rate per period. |
| Arg2 | Required | Double | Per - the period for which you want to find the interest; must be in the range 1 to nper. |
| Arg3 | Required | Double | Nper - the total number of payment periods in an annuity. |
| Arg4 | Required | Double | Pv - the present value, or the lump-sum amount that a series of future payments is worth right now. |
| Arg5 | Optional | Variant | Fv - the future value, or a cash balance that you want to attain after the last payment is made. If fv is omitted, it is assumed to be 0 (the future value of a loan, for example, is 0). |
| Arg6 | Optional | Variant | Type - the number 0 or 1 and indicates when payments are due. If type is omitted, it is assumed to be 0. |
Return value
Double
Remarks
The following table describes the values that can be used for Arg6.
| Set type equal to | If payments are due |
|---|---|
| 0 | At the end of the period |
| 1 | At the beginning of the period |
Make sure that you are consistent about the units that you use for specifying rate and nper. If you make monthly payments on a four-year loan at 12 percent annual interest, 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.
For all the arguments, cash you pay out, such as deposits to savings, is represented by negative numbers; cash you receive, such as dividend checks, is represented by positive numbers.
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.