CUMPRINC
返回 start_period 和 end_period 之间为贷款支付的累计本金。
语法
CUMPRINC(<rate>, <nper>, <pv>, <start_period>, <end_period>, <type>)
parameters
术语 | 定义 |
---|---|
rate | 利率。 |
nper | 付款期总数。 |
pv | 现值。 |
start_period | 计算中的第一个周期。 必须介于 1 至 end_period 之间(含首尾)。 |
end_period | 计算中的最后一个周期。 必须介于 start_period 至 nper 之间(含首尾)。 |
类型 | 付款时间。 此表下方列出了可接受的值。 |
type 参数接受以下值:
类型 | 定时 |
---|---|
0(零) | 期末付款 |
1 | 期初付款 |
返回值
在指定期间内累计支付的本金。
备注
确保用于指定 rate 和 nper 的单位是一致的。 如果你每月以 10% 的年利率偿还 4 年期贷款,则利率 rate 为 0.1/12,nper 为 4*12。 如果你每年偿还金额相同的贷款,则利率 rate 为 0.1,nper 为 4。
start_period、end_period 和 type 舍入为最接近的整数。
如果出现以下情况,则返回错误:
- 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{ CUMPRINC(0.09/12, 30*12, 125000, 13, 24, 1) }
假设在每月初还款,则返回在第二年还款期(第 13 至 24 期)中支付的本金总额。
[值] |
---|
-927.153472378062 |
示例 2
以下 DAX 查询:
EVALUATE{ CUMPRINC(0.09/12, 30*12, 125000, 1, 1, 0) }
假设在月底还款,则返回在第一个月以单笔款项支付的本金。
[值] |
---|
-68.2782711809784 |