DURATION
傳回假設 par 值為 \$100 的麥考雷存續期 (Macauley Duration)。 存續期間是現金流量現值的加權平均值，用於衡量因殖利率變更而改變的債券價格。
語法
DURATION(<settlement>, <maturity>, <coupon>, <yld>, <frequency>[, <basis>])
參數
| 詞彙 | 定義 |
|---|---|
| settlement | 證券的結算日期。 證券結算日期是在發行日之後，證券賣給買方的日期。 |
| maturity | 證券到期日。 到期日是證券到期的日期。 |
| coupon | 證券的年息票利率。 |
| yld | 證券的年度收益。 |
| 頻率 | 每年息票付款的次數。 若為每年給付一次，frequency = 1；若為每半年給付一次，frequency = 2；若為每季給付一次，frequency = 4。 |
| basis | (選擇性) 要使用的天數計算基礎類型。 如果省略 basis，則會假設為 0。 接受的值會列在此資料表下方。 |
basis 參數接受下列值：
| Basis | 天數計算基準 |
|---|---|
| 0 或省略 | US (NASD) 30/360 |
| 1 | 實際值/實際值 |
| 2 | 實際值/360 |
| 3 | 實際值/365 |
| 4 | 歐洲 30/360 |
傳回值
麥考雷存續期 (Macauley Duration)。
備註
日期會以連續的序號來儲存，以便計算。 在 DAX 中，1899 年 12 月 30 日是第 0 天，而 2008 年 1 月 1 日因為是 1899 年 12 月 30 日之後的第 39,448 天，所以是第 39448 天。
結算日是買方購買息票 (例如債券) 的日期。 到期日是息票到期的日期。 例如，假設 30 年的債券在 2008 年 1 月 1 日發行，而買方在六個月後購買此債券。 發行日期為 2008 年 1 月 1 日，結算日為 2008 年 7 月 1 日，而到期日則為發行日 2008 年 1 月 1 日之後 30 年，即 2038 年 1 月 1 日。
settlement 和 maturity 會取至整數。
frequency 和 basis 會四捨五入為最接近的整數。
如果是下列情況，則會傳回錯誤：
- settlement 或 maturity 不是有效的日期。
- settlement ≥ maturity。
- coupon < 0。
- yld < 0
- frequency 是 1、2 或 4 以外的任何數字。
- basis < 0 或 basis > 4。
在計算結果欄或資料列層級安全性 (RLS) 規則中使用時，不支援在 DirectQuery 模式中使用此函式。
範例
| Data | 說明 |
|---|---|
| 07/01/2018 | 結算日期 |
| 01/01/2048 | 到期日 |
| 8.0% | 息票利率 |
| 9.0% | 收益百分比 |
| 2 | 每半年給付 (請參閱上文) |
| 1 | 實際/實際基準 (請參閱上文) |
下列 DAX 查詢：
EVALUATE
{
DURATION(DATE(2018,7,1), DATE(2048,1,1), 0.08, 0.09, 2, 1)
}
針對具有上述指定期間的債券傳回麥考雷存續期 (Macauley Duration)。
| [值] |
|---|
| 10.9191452815919 |