RECEIVED
全額投資された証券に対して、満期日に支払われる金額を返します。
構文
RECEIVED(<settlement>, <maturity>, <investment>, <discount>[, <basis>])
パラメーター
| 用語 | 定義 |
|---|---|
| settlement | 証券の受渡日。 証券の受渡日とは、発行日の後、証券が買い手に引き渡される日付です。 |
| maturity | 証券の満期日。 満期日とは、証券の有効期限日です。 |
| investment | 証券への投資金額。 |
| discount | 証券の割引率。 |
| 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 日になります。
RECEIVED は、次のように計算されます。
$$\text{RECEIVED} = \frac{\text{investment}}{1 - (\text{discount} \times \frac{\text{DIM}}{\text{B}})}$$
ここで、
- $\text{B}$ = 年基準に応じた、1 年の日数。
- $\text{DIM}$ = 発行から満期までの日数。
settlement と maturity は、整数に切り捨てられます。
basis は、最も近い整数に丸められます。
次の場合はエラーが返されます。
- settlement または maturity が有効な日付ではない。
- settlement ≥ maturity。
- investment ≤ 0。
- discount ≤ 0。
- basis < 0 または basis > 4。
この関数は、計算列または行レベルのセキュリティ (RLS) ルールで使用される場合、DirectQuery モードでの使用はサポートされません。
例
次の DAX クエリを実行します。
| データ | 説明 |
|---|---|
| 2008 年 2 月 15 日 | 受渡 (発行) 日 |
| 2008 年 5 月 15 日 | 満期日 |
| \$1,000,000.00 | 投資金 |
| 5.75% | 割引率 (%) |
| 2 | 実際の日数/360 日ベース |
EVALUATE
{
RECEIVED(DATE(2008,2,15), DATE(2008,5,15), 1000000.00, 0.0575, 2)
}
上記で指定した条件の債券について、満期日に支払われる合計金額を返します。
| [値] |
|---|
| 1014584.6544071 |