COUPNUM
決済日と満期日の間の利息支払回数を返します。端数が出た場合は切り上げられます。
構文
COUPNUM(<settlement>, <maturity>, <frequency>[, <basis>])
パラメーター
| 用語 | 定義 |
|---|---|
| settlement | 証券の受渡日。 証券の受渡日とは、発行日の後、証券が買い手に引き渡される日付です。 |
| maturity | 証券の満期日。 満期日とは、証券の有効期限日です。 |
| 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 日になります。
settlement と maturity は、整数に切り捨てられます。
frequency と basis は、最も近い整数に丸められます。
次の場合はエラーが返されます。
- settlement または maturity が有効な日付ではない。
- settlement ≥ maturity。
- frequency が 1、2、または 4 以外の任意の数値である。
- basis < 0 または basis > 4。
この関数は、計算列または行レベルのセキュリティ (RLS) ルールで使用される場合、DirectQuery モードでの使用はサポートされません。
例
| データ | 説明 |
|---|---|
| 25-Jan-07 | 決済日 |
| 15-Nov-08 | 満期日 |
| 2 | 半年ごとの利札 (上記を参照) |
| 1 | 実際の日数/実際の日数基準 (上記を参照) |
次の DAX クエリを実行します。
EVALUATE
{
COUPNUM(DATE(2007,1,25), DATE(2008,11,15), 2, 1)
}
上記のように指定した債券に対して、利息支払回数を返します。
| [値] |
|---|
| 4 |