WPS 加载项开发 > 表格 API 参考 > WorksheetFunction > 方法 > WorksheetFunction.Rate 方法
返回年金的各期利率。函数 RATE 通过迭代法计算得出,并且可能无解或有多个解。如果在进行 20 次迭代计算后,函数 RATE 的相邻两次结果没有收敛于 0.0000001,则函数 RATE 将返回错误值 #NUM!。

语法

表达式.Rate(Arg1, Arg2, Arg3, Arg4, Arg5, Arg6)

表达式   一个代表 WorksheetFunction 对象的变量。

参数

名称必选/可选数据类型说明
Arg1必选DoubleNper - 年金中的总付款期数。
Arg2必选DoublePmt - 各期付款额,其数值在年金的整个时间期限内保持不变。通常 pmt 包括本金和利息,但不包括其他费用或税金。如果省略 pmt,则必须包含 fv 参数。
Arg3必选DoublePv - 现值,即一系列未来付款当前所值的总额。
Arg4可选VariantFv - 未来值,或在最后一次付款后希望得到的现金余额。如果省略 fv,则假定其值为 0(例如,一笔贷款的未来值为 0)。
Arg5可选VariantType - 数字 0 或 1,用以指示付款时间。
Arg6可选VariantGuess - 猜测的利率。

返回值
Double

说明

有关参数 nper、pmt、pv、fv 和 type 的完整说明,请参阅 PV。

Type 值付款时间
0 或省略期末
1期初

应确保所指定的 guess 和 nper 单位的一致性。例如,同样是四年期年利率为 12% 的贷款,如果按月支付,guess 应为 12%/12,nper 应为 4*12;如果按年支付,guess 应为 12%,nper 应为 4。


请参阅