YIELD
定期的な利息を支払う証券の利回りを返します。 YIELD を使用して債券利回りを計算します。
構文
YIELD(<settlement>, <maturity>, <rate>, <pr>, <redemption>, <frequency>[, <basis>])
パラメーター
用語 | 定義 |
---|---|
settlement |
証券の受渡日。 証券決済日は、証券が購入者に取引される発行日の後の日付です。 |
maturity |
セキュリティの成熟日。 満期日は、セキュリティの有効期限が切れる日付です。 |
rate |
セキュリティの年間利率。 |
pr |
\$100 額当たりのセキュリティの価格。 |
redemption |
額面 \$100 あたりのセキュリティの引き換え額。 |
frequency |
1 年あたりのクーポン支払いの数。 年払いの場合は frequency = 1、半年ごとの場合は frequency = 2、四半期ごと場合は frequency = 4。 |
basis |
(省略可能)使用する日数基準の種類。 基準を省略すると、0 と見なされます。 この表の下に、使用できる値を示します。 |
basis
パラメーターは、次の値を受け入れます。
Basis |
日数基準 |
---|---|
0 または省略 | 米国 (NASD) 30/360 |
1 | 実際の日数/実際の日数 |
2 | 実際の日数/360 日 |
3 | 実際の日数/365 日 |
4 | 30 日/360 日 (ヨーロッパ方式) |
戻り値
セキュリティの利回り。
解説
日付は、計算で使用できるように、連続するシリアル番号として格納されます。 DAXでは、1899 年 12 月 30 日は 0 日目、1899 年 12 月 30 日から 39,448 日後であるため、2008 年 1 月 1 日は 39448 です。
受渡日は、買い手が債券などのクーポンを購入した日付です。 満期日は、クーポンの有効期限が切れる日付です。 たとえば、30 年債が 2008 年 1 月 1 日に発行され、6 か月後に購入者によって購入されたとします。 発行日は 2008 年 1 月 1 日、受渡日は 2008 年 7 月 1 日、満期日は 2038 年 1 月 1 日であり、発行日は 2008 年 1 月 1 日から 30 年後になります。
引き換えまでの利払期間が 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に使用される数式に基づいて、Newton メソッドを使用します。 利回りは、利回りが価格に近づくと推定価格になるまで変更されます。
受渡日と満期日は整数に切り捨てられます。
頻度と基準は、最も近い整数に丸められます。
次の場合、エラーが返されます。
- 受渡日または満期日が有効な日付ではありません。
- settlement ≥ maturity。
- rate < 0。
- pr ≤ 0。
- redemption ≤ 0。
- 頻度は、1、2、または 4 以外の任意の数です。
- 基準 < 0 または基準 > 4。
この関数は、計算列または行レベル セキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。
例
データ | 説明 |
---|---|
2008 年 2 月 15 日 | 受渡日 |
15-Nov-16 | 満期日 |
5.75% | 表面利率 |
95.04287 | 価格 |
\$100 | 引き換え額 |
2 | 頻度は半年に 1 回 (上記を参照) |
0 | 30/360 日ベース (上記を参照) |
次の DAX クエリ:
EVALUATE
{
YIELD(DATE(2008,2,15), DATE(2016,11,15), 0.0575, 95.04287, 100, 2,0)
}
上記で指定した条件を持つ債券の利回りを返します。
[値] |
---|
0.0650000068807314 |