共用方式為

CUMIPMT

  • 發行項

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

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

語法

CUMIPMT(<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
{
  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