User Tools

Site Tools


syntax:functions:ipmt

IPmt(rate, per, num_per, curr_val)

Category: Number (Financial) function


Description

This function calculates the interest payment for a given period for an investment .


Additional syntax

Optional future value (fut_val) argument.

IPmt(rate, per, num_per, curr_val, fut_val)


Optional payments due (pay_due) argument.

IPmt(rate, per, num_per, curr_val, fut_val, pay_due)


Arguments

ArgumentTypeDescription
rateNumber (decimal)The interest rate of the loan (entered as a decimal).
perNumberThe period of the interest payment. Must be a value between 1 and num_per.
num_perNumberThe number of payments of the loan (usually in months or years).
curr_valNumberThe current value of the loan.
fut_valNumberOptional. The future value to be achieved after the last payment (i.e., "0" to pay the loan off in full).
The default, if not supplied, is 0.
pay_dueBinary (0 or 1)Optional. This value defines when payments are due. Options: 0 (the beginning of the period; default),
or 1 (the end of the period).


Return value type: Number


Remarks

For an accurate calculation, be sure to convert rate and num_per to the same time period. If calculating a monthly payment and rate is an annual rate, divide it by 12 (rate / 12). If num_per is given as years, multiply by 12 (num_per * 12).


Examples

Calculate the annual interest payment for period 1: Annual rate of 8%, for period 1, number of periods is 3 years, value is $20,000, (final value = default, 0).

ipmt(0.08, 1,  3, 20000) //Returns -1600 (annual payment, rounded)


Calculate the monthly interest payment for period 24: Annual rate of 6%, number of periods is 48 months, value is $10,000, final value is 0 (paid off).

ipmt(0.06/12, 24, 48, 10000, 0)  //Returns -27.53 (monthly payment, rounded)


Calculate the monthly interest payment for period 20: Annual rate of 10%, number of periods is 2 years, value is $8,000, final value is 0 (paid off), with payments due at the end of the period.

ipmt(0.10/12,20, 2*12, 8000, 0, 1)  //Returns -14.88 (monthly payment, rounded)


Calculate the monthly interest payment for period 25: Annual rate of 10%, number of periods is 2 years, value is $8,000, final value is 0 (paid off), with payments due at the end of the period.

ipmt(0.10/12,25, 2*12, 8000,0,1)  //Returns an error.  "Per" is outside of 1-24 (the # of months).


See also

syntax/functions/ipmt.txt · Last modified: 2021/10/24 00:32 by craigt

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki