CUMPRINC

适用于:计算列计算表Measure视觉计算

返回在start_period and end_period之间贷款支付的累计本金。

语法

DAX
CUMPRINC(<rate>, <nper>, <pv>, <start_period>, <end_period>, <type>)

参数

术语 定义
rate 兴趣 rate。
nper 付款周期总数。
pv 当前 value。
start_period 计算中的 first 周期。 必须介于 1 and end_period(含) 之间。
end_period 计算中的 last 周期。 必须介于 start_period andnper(含) 之间。
type 付款的时间。 下表下面列出了接受的 values。

type 参数接受以下 values:

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

返回 Value

在指定时间段内支付的累积主体。

言论

  • 请确保与用于指定 rateandnper的单位保持一致。 If 按年利息 rate 10% 的四year 贷款每月付款,rateand 4*12 用于 nper。 If 对同一贷款进行年付款,请使用 0.1 rateand 4 用于 nper。

  • start_period、end_period、and 类型四舍五入为最接近的整数。

  • if返回 error:

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

例子

数据 说明
9% 年度利息 rate
30 期限(以年为单位)
125000 演示 value

示例 1

以下 DAX 查询:

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

返回在付款 secondyear 中支付的总本金,期限为 13 至 24,假设在每个 month开始时付款。

[Value]
-927.153472378062

示例 2

以下 DAX 查询:

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

返回在 firstmonth中以单个付款形式支付的本金,假设在 month结束时付款。

[Value]
-68.2782711809784