YIELD

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

傳回定期支付利息之證券的收益。 使用 YIELD 來計算債券收益。

語法

YIELD(<settlement>, <maturity>, <rate>, <pr>, <redemption>, <frequency>[, <basis>])

參數

詞彙	定義
settlement	證券的結算日期。 證券結算日期是在發行日之後，證券賣給買方的日期。
maturity	證券到期日。 到期日是證券到期的日期。
速率	證券的年息票利率。
pr	證券每 \$100 元面額的價格。
redemption	證券每 \$100 元面額的贖回價值。
頻率	每年息票付款的次數。 若為每年給付一次，frequency = 1；若為每半年給付一次，frequency = 2；若為每季給付一次，frequency = 4。
basis	(選擇性) 要使用的天數計算基礎類型。 如果省略 basis，則會假設為 0。 接受的值會列在此資料表下方。

basis 參數接受下列值：

Basis	天數計算基準
0 或省略	US (NASD) 30/360
1	實際值/實際值
2	實際值/360
3	實際值/365
4	歐洲 30/360

傳回值

證券收益。

備註

• 日期會以連續的序號來儲存，以便計算。 在 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 日。

• 如果在贖回之前有一個以下的計息期間，YIELD 的計算如下：

  $$\text{YIELD} = \frac{(\frac{\text{redemption}}{100} + \frac{\text{rate}}{\text{frequency}}) - (\frac{\text{par}}{100} + (\frac{\text{A}}{\text{E}} \times \frac{\text{rate}}{\text{frequency}}))}{\frac{\text{par}}{100} + (\frac{\text{A}}{\text{E}} \times \frac{\text{rate}}{\text{frequency}})} \times \frac{\text{frequency} \times \text{E}}{\text{DSR}}$$

  其中：

  • $\text{A}$ = 自息票週期開始至結算日期之間的天數 (應計天數)。
  • $\text{DSR}$ = 自結算日期至贖回日期之間的天數。
  • $\text{E}$ = 計息期間的天數。

• 如果在贖回之前有一個以上的計息期間，YIELD 會反覆計算 100 次。 解算過程會使用牛頓法，並根據函式 PRICE 所使用的公式。 收益會不斷變動，直到依指定收益計算的估算價格與實際價格接近為止。

• settlement 和 maturity 會取至整數。

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

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

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

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

範例

Data	說明
15-Feb-08	結算日期
15-Nov-16	到期日
5.75%	息票利率
95.04287	價格
\$100	贖回價值
2	每半年給付 (請參閱上文)
0	30/360 基準 (請參閱上文)

下列 DAX 查詢：

EVALUATE
{
  YIELD(DATE(2008,2,15), DATE(2016,11,15), 0.0575, 95.04287, 100, 2,0)
}

根據上述指定條件傳回債券收益。

[Value]
0.0650000068807314