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 |