跳到主要内容

IPMT

基于定期、固定付款和固定利率,返回投资在给定期间的利息支付额。

语法

expression.IPMT(arg1, arg2, arg3, arg4, arg5, arg6);

expression - 表示 ApiWorksheetFunction 类的变量。

参数

名称必需/可选数据类型默认值描述
arg1必需ApiRange | ApiName | number每期的利率。例如,按 6% 年利率进行季度付款时使用 6%/4。
arg2必需ApiRange | ApiName | number将返回利息的期间。必须在 1 到总付款期数的范围内。
arg3必需ApiRange | ApiName | number投资的付款期总数。
arg4必需ApiRange | ApiName | number现值,或一系列未来付款现在的一次性总额。
arg5可选ApiRange | ApiName | number未来值,或最后一次付款后将达到的现金余额。如果省略,则等于 0。
arg6可选ApiRange | ApiName | number表示付款时间的逻辑值:期末 = 0 或省略,期初 = 1。

返回值

number

示例

此示例演示如何根据定期固定付款和固定利率返回投资在给定期间的利息付款。

// How to calculate the interest payment for a given period for an investment.

// Use a function to get the interest payment.

let worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
worksheet.GetRange("A1").SetValue(func.IPMT(0.1/12, 1, 2*12, 2000, 0));