Skip to main content

PMT

Calculates the payment for a loan based on constant payments and a constant interest rate.

Syntax

expression.PMT(arg1, arg2, arg3, arg4, arg5);

expression - A variable that represents a ApiWorksheetFunction class.

Parameters

NameRequired/OptionalData typeDefaultDescription
arg1RequiredApiRange | ApiName | numberThe interest rate per period for the loan. For example, use 6%/4 for quarterly payments at 6% APR.
arg2RequiredApiRange | ApiName | numberThe total number of payments for the loan.
arg3RequiredApiRange | ApiName | numberThe present value: the total amount that a series of future payments is worth now.
arg4OptionalApiRange | ApiName | numberThe future value, or a cash balance which will be attained after the last payment is made. If omitted, it is equal to 0.
arg5OptionalApiRange | ApiName | numberA logical value: payment at the beginning of the period = 1; payment at the end of the period = 0 or omitted.

Returns

number

Example

let worksheet = Api.GetActiveSheet();
let func = Api.GetWorksheetFunction();
worksheet.GetRange("A1").SetValue(func.PMT(0.08/12, 2*12, 10000, 0));