ODDFYIELD
傳回零散首期 (短期或長期) 的證券收益。
語法
ODDFYIELD(<settlement>, <maturity>, <issue>, <first_coupon>, <rate>, <pr>, <redemption>, <frequency>[, <basis>])
參數
詞彙 | 定義 |
---|---|
settlement | 證券的結算日期。 證券結算日期是在發行日之後,證券賣給買方的日期。 |
maturity | 證券到期日。 到期日是證券到期的日期。 |
問題 | 證券的發行日期。 |
first_coupon | 證券的第一個付息日期。 |
速率 | 證券的利率。 |
pr | 證券的價格。 |
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 日。
ODDFYIELD 會使用反覆運算方法來計算。 期使用牛頓法,並根據函式 ODDFPRICE 所使用的公式。 收益會隨著 100 次反覆運算而變更,直到具有指定收益的預估價格接近實際價格為止。 如需 ODDFYIELD 所使用的公式,請參閱 ODDFPRICE。
settlement、maturity、issue 及 first_coupon 都會取至整數。
basis 和 frequency 會四捨五入為最接近的整數。
如果是下列情況,則會傳回錯誤:
- settlement、maturity、issue 或 first_coupon 不是有效的日期。
- 不符合 maturity > first_coupon > settlement > issue。
- rate < 0。
- pr ≤ 0。
- redemption ≤ 0。
- frequency 是 1、2 或 4 以外的任何數字。
- basis < 0 或 basis > 4。
在計算結果欄或資料列層級安全性 (RLS) 規則中使用時,不支援在 DirectQuery 模式中使用此函式。
範例
Data | 引數描述 |
---|---|
2008 年 11 月 11 日 | 結算日期 |
2021 年 3 月 1 日 | 到期日 |
2008 年 10 月 15 日 | 發行日期 |
2009 年 3 月 1 日 | 首次付息日期 |
5.75% | 息票利率 |
84.50 | 價格 |
100 | 贖回值 |
2 | 每半年給付 |
0 | 30/360 基準 |
下列 DAX 查詢:
EVALUATE
{
ODDFYIELD(DATE(2008,11,11), DATE(2021,3,1), DATE(2008,10,15), DATE(2009,3,1), 0.0575, 84.50, 100, 2, 0)
}
使用上方指定的條件,傳回具有零散第一期 (短期或長期) 的證券收益。
[Value] |
---|
0.0772455415972989 |