共用方式為


CUMPRINC

適用於:計算結果列匯出數據表量值視覺計算

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

語法

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

參數

詞彙 定義
速率 利率。
nper 付款週期總數。
pv 現值。
start_period 計算的第一個週期。 必須介於 1 與 end_period (不含) 之間。
end_period 計算的最後一個週期。 必須介於 start_period 和 nper (含) 之間。
type 付款時間。 接受的值會列在此資料表下方。

type 參數會接受下列值:

類型 時間
0 (zero) 期末付款
1 期初付款

傳回值

在指定期間內所支付的累計本金。

備註

  • 請確定您用來指定利率和 nper 的單位一致。 如果您進行每月付款的四年期貸款,且利率為 10%,請使用 0.1/12 作為利率,並使用 4*12 作為 nper。 如果您針對相同的貸款進行年度付款,請使用 0.1 作為利率,並使用 4 作為 nper。

  • 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 模式中使用此函式。

範例

Data 說明
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