YIELD
傳回支付定期利息之證券的收益。 使用 YIELD 來計算債券收益率。
語法
YIELD(<settlement>, <maturity>, <rate>, <pr>, <redemption>, <frequency>[, <basis>])
參數
| 詞彙 | 定義 |
|---|---|
settlement |
證券的結算日期。 證券結算日期是證券交易給買家的發行日期之後的日期。 |
maturity |
安全性的到期日。 到期日是安全性到期的日期。 |
rate |
證券的年度票息率。 |
pr |
每個 \$100 面值的安全性價格。 |
redemption |
每個 \$100 面額的安全性兌換值。 |
frequency |
每年的優惠券付款數目。 若為每年給付一次，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日是39448年，因為它是1899年12月30日之後的39,448天。
結算日期是買家購買優惠券的日期，例如債券。 到期日是優惠券到期的日期。 例如，假設 2008 年 1 月 1 日發行 30 年期債券，並在六個月後由買家購買。 發行日期為 2008 年 1 月 1 日，結算日期為 2008 年 7 月 1 日，到期日為 2038 年 1 月 1 日，也就是 2008 年 1 月 1 日發行日期之後的 30 年。
如果兌換前有一個優惠券期間或更少，YIELD 計算如下：
$$\text{YIELD} = \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}} \times \frac{\text{frequency} \times \text{E}}{\text{DSR}}}$$
其中：
- $\text{A}$ = 票息周期開頭到結算日期（累算天數）的天數。
- $\text{DSR}$ = 從結算日期到兌換日期的天數。
- $\text{E}$ = 計息期間的天數。
如果兌換前有一個以上的優待券期間，YIELD 會透過一百次反覆運算來計算。 解析會根據函式所使用的公式，使用 Newton 方法 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)
}
傳回債券上的收益，其中包含上述指定的詞彙。
| [值] |
|---|
| 0.0650000068807314 |