CUMPRINC

適用於:匯出數據行計算數據表量值視覺計算

傳回在start_period和end_period之間以貸款支付的累計本金。

語法

CUMPRINC(<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 期間開頭的付款

傳回值

在指定期間內支付的累計主體。

言論

  • 請確定您對於指定 rate 和 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
{
  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