The IPMT function calculates the amount of interest to be paid on a loan in a given payment period. The function assumes a consistent interest rate and payment timings in each period.

For example, you can use the IPMT function to see how the interest due changes over the duration of loan.

IPMT(Interest rate, Period to examine, Number of periods, Present value [, Future value] [, Payment timing])

ArgumentData typeDescription
Interest rate (required)Number

The interest rate to apply to the Present value each period.

This argument is best used with the Percent format, as 0.1 equals 10%, and so on.

Period to examine (required)NumberThe period to return the amount of interest due for.
Number of periods (required)NumberThe number of periods that the Present value is paid over.
Present value (required)NumberThe total amount to be paid over the Number of periods.
Future valueNumberThe amount of loan left after the final payment is made. If omitted, this assumed to be 0.
Payment timingNumber

Whether interest payments are made at the start or end of each period.

0 means payments are made at the end of each period. This is the default behavior if you omit the Payment timing argument.

A non-zero value means payments are made at the start end.

The IPMT function returns a number, which is the interest due in the Period to examine.

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

The Period to examine and Number of periods arguments enable you to specify the number of periods interest accrues over, and the period for which to view the interest.

The values you provide for the Interest rate, Period to examine, and Number of periods arguments should all use the same time scale. For example, if the periods are years, you should provide the annual interest rate.

For any values you give for the Present value or Future value arguments, or that the IPMT 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.

IPMT

In this example, a module has eight line items on rows, and a Loans list on columns. The first four line items contain data for each of the required arguments for the IPMT function. The fifth line item uses the IPMT function to calculate interest payments.

The sixth and seventh line items contain data for the optional arguments for the IPMT function. The eighth line item uses the IPMT function to calculate interest payments with both optional arguments applied.


Loan 1Loan 2Loan 3Loan 4Loan 5
Present value70,000330,000500,000500,000500,000
Interest rate5.5%3.5%1.44%1.44%1.44%
Period to examine11101010
Number of periods625252525

Interest due for period

IPMT(Interest rate, Period to examine, Number of periods, Present value)

-3,850-8,475.38-4,898.82-4,898.82-4,898.82
Future value030,000010,00010,000
Timing00001

Amended interest due for period

IPMT(Interest rate, Period to examine, Number of periods, Present value, Future value, Timing)

-3,850-8,195.87-4,898.82-4,852.79-4,783.90