MDURATION

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

針對假設面值為 \$100 的證券，傳回修改過的麥考雷存續期 (Macauley Duration)。

語法

MDURATION(<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 日。

• 修改過的存續期定義如下：

  $$\text{MDURATION} = \frac{\text{DURATION}}{1 + (\frac{\text{Market yield}}{\text{每年息票付款}})}$$

• settlement 和 maturity 會取至整數。

• frequency 和 basis 會四捨五入為最接近的整數。

• 如果是下列情況，則會傳回錯誤：

  • settlement 或 maturity 不是有效的日期。
  • settlement ≥ maturity。
  • coupon < 0。
  • yld < 0
  • frequency 是 1、2 或 4 以外的任何數字。
  • basis < 0 或 basis > 4。

• 在計算結果欄或資料列層級安全性 (RLS) 規則中使用時，不支援在 DirectQuery 模式中使用此函式。

範例

Data	說明
1/1/2008	結算日期
1/1/2016	到期日
8%	息票利率
9%	收益百分比
2	每半年給付 (請參閱上文)
1	實際/實際基準 (請參閱上文)

下列 DAX 查詢：

EVALUATE
{
  MDURATION(DATE(2008,1,1), DATE(2016,1,1), 0.08, 0.09, 2, 1)
}

針對使用上述指定期間的債券傳回已修改麥考雷存續期 (Macauley Duration)。

[值]
5.73566981391884