ODDFYIELD
最初の期間が奇数の (短期または長期) 証券の利回りを返します。
構文
ODDFYIELD(<settlement>, <maturity>, <issue>, <first_coupon>, <rate>, <pr>, <redemption>, <frequency>[, <basis>])
パラメーター
| 用語 | 定義 |
|---|---|
| settlement | 証券の受渡日。 証券の受渡日とは、発行日の後、証券が買い手に引き渡される日付です。 |
| maturity | 証券の満期日。 満期日とは、証券の有効期限日です。 |
| イシュー | 証券の発行日。 |
| first_coupon | 証券の最初の利払日。 |
| rate | 証券の利率。 |
| pr | 証券の価格。 |
| redemption | 額面 \$100 あたりの証券の償還価額。 |
| frequency | 年あたりの利息支払回数。 年払いの場合は frequency = 1、半年ごとの場合は frequency = 2、四半期ごと場合は frequency = 4。 |
| basis | (任意) 日数の計算に使用する基準の種類。 basis を省略した場合は、0 であると見なされます。 指定できる値をこの表の下に示します。 |
basis パラメーターには、次の値を指定できます。
| 基準 | 日数の基準 |
|---|---|
| 0 または省略 | 米国 (NASD) 30/360 |
| 1 | 実際の日数/実際の日数 |
| 2 | 実際の日数/360 日 |
| 3 | 実際の日数/365 日 |
| 4 | 30 日/360 日 (ヨーロッパ方式) |
戻り値
証券の利回り。
解説
日付は、計算で使用できるように、連続するシリアル番号として格納されます。 DAX では、1899 年 12 月 30 日が 0 日目であり、2008 年 1 月 1 日は、1899 年 12 月 30 日の 39,448 日後であるため、39,448 日目となります。
受渡日は、買い手が債券などの利札を購入した日付です。 満期日は、利札の有効期限日です。 たとえば、30 年債が 2008 年 1 月 1 日に発行され、6 か月後に買い手が購入したとします。 発行日は 2008 年 1 月 1 日になり、受渡日は 2008 年 7 月 1 日、満期日は発行日の 2008 年 1 月 1 日から 30 年後の 2038 年 1 月 1 日になります。
ODDFYIELD は反復法を使用して計算されます。 ここでは、ODDFPRICE 関数に使用される数式に基づいて、ニュートン法が使用されます。 利回りは、指定された利回りでの推定価格がその価格に近づくまで、100 回の反復で変更されます。 ODDFYIELD で使用される数式については、ODDFPRICE を参照してください。
settlement、maturity、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 モードでの使用はサポートされません。
例
| データ | 引数の説明 |
|---|---|
| 2008 年 11 月 11 日 | 受渡日 |
| 2021 年 3 月 1 日 | 満期日 |
| 2008 年 10 月 15 日 | 発行日 |
| 2009 年 3 月 1 日 | 最初の利払日 |
| 5.75% | 表面利率 |
| 84.50 | Price |
| 100 | 償還価値 |
| 2 | 頻度は半年に 1 回 |
| 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)
}
上記で指定した条件を使用して、最初の期間が奇数の (短期または長期) 証券の利回りを返します。
| [値] |
|---|
| 0.0772455415972989 |