Edit

Share via


WorksheetFunction.Ppmt(Double, Double, Double, Double, Object, Object) Method

Definition

Returns the payment on the principal for a given period for an investment based on periodic, constant payments and a constant interest rate.

public double Ppmt (double Arg1, double Arg2, double Arg3, double Arg4, object Arg5, object Arg6);
Public Function Ppmt (Arg1 As Double, Arg2 As Double, Arg3 As Double, Arg4 As Double, Optional Arg5 As Object, Optional Arg6 As Object) As Double

Parameters

Arg1
Double

Rate - the interest rate per period.

Arg2
Double

Per - the period and must be in the range 1 to nper.

Arg3
Double

Nper - the total number of payment periods in an annuity.

Arg4
Double

Pv - the present value — the total amount that a series of future payments is worth now.

Arg5
Object

Fv - the future value, or a cash balance you want to attain after the last payment is made. If fv is omitted, it is assumed to be 0 (zero), that is, the future value of a loan is 0.

Arg6
Object

Type - the number 0 or 1 and indicates when payments are due.

Returns

Remarks

For a more complete description of the arguments in Ppmt, see Pv(Double, Double, Double, Object, Object).

0 or omittedAt the end of the period
1At the beginning of the period

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

Applies to