跳到主要内容

RATE

返回贷款或投资的每期利率。例如,使用 6%/4 表示年利率 6% 的季度付款。

语法

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

expression - 表示 ApiWorksheetFunction 类的变量。

参数

名称必需/可选数据类型默认值描述
arg1必需ApiRange | ApiName | number贷款或投资的总付款期数。
arg2必需ApiRange | ApiName | number每期的付款额,在贷款或投资期限内不能更改。
arg3必需ApiRange | ApiName | number现值:一系列未来付款现在的总金额。
arg4可选ApiRange | ApiName | number未来值,或最后一次付款后将达到的现金余额。如果省略,则等于 0。
arg5可选ApiRange | ApiName | number逻辑值:期初付款 = 1;期末付款 = 0 或省略。
arg6可选ApiRange | ApiName | number对利率的估计值。如果省略,函数将假定估计值为 0.1(10%)。

返回值

number

示例

此示例演示如何返回贷款或投资每期的利率。例如,按 6% 年利率进行季度付款时使用 6%/4。

// How to estimate the interest rate per period for a loan or an investment.

// Use a function to get the loan/investment interest rate per period.

let worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
worksheet.GetRange("A1").SetValue(func.RATE(2*12, -500, 10000, 0));