CUMIPMT

适用于:计算列计算表度量值视觉计算

返回start_period和end_period之间贷款的累计利息。

语法

CUMIPMT(<rate>, <nper>, <pv>, <start_period>, <end_period>, <type>)

参数

术语 定义
rate 利率。
nper 付款周期总数。
pv 当前值。
start_period 计算中的第一个周期。 必须介于 1 和 end_period 之间(含)。
end_period 计算中的最后一个时间段。 必须在start_period和 nper 之间(含)。
type 付款的时间。 此表下面列出了接受的值。

type 参数接受以下值:

Type 计时
0 (零) 期末付款
1 期初付款

返回值

在指定时间段内支付的累计利息。

言论

  • 请确保与用于指定速率和 nper 的单位保持一致。 如果按年利率为 10% 的四年期贷款每月付款,则对利率使用 0.1/12,nper 使用 4*12。 如果对同一贷款进行年度付款,请对 nper 使用 0.1 支付利率和 4。

  • start_period、end_period和类型将舍入为最接近的整数。

  • 如果出现以下错误,则返回错误:

    • rate ≤ 0.
    • nper < 1。
    • pv ≤ 0.
    • start_period < 1 或start_period > end_period。
    • end_period < start_period或end_period > nper。
    • type 是 0 或 1 以外的任意数字。
  • 在计算列或行级别安全性 (RLS) 规则中使用时,不支持在 DirectQuery 模式下使用此函数。

例子

数据 说明
9% 年利率
30 贷款年数
125000 现值

示例 1

以下 DAX 查询:

EVALUATE
{
  CUMIPMT(0.09/12, 30*12, 125000, 13, 24, 1)
}

返回第二年付款中支付的总利息(第 13 至 24 期)假设付款是在每月开始时支付的。

[值]
-11052.3395838718

示例 2

以下 DAX 查询:

EVALUATE
{
  CUMIPMT(0.09/12, 30*12, 125000, 1, 1, 0)
}

返回第一个月的单个付款中支付的利息,假设付款是在月底付款。

[值]
-937.5