WorksheetFunction メソッド (Excel)WorksheetFunction.CoupNum method (Excel)

受渡日と満期日の間に利息が支払われる回数を返します。端数が出た場合は切り上げられます。Returns the number of coupons payable between the settlement date and maturity date, rounded up to the nearest whole coupon.

構文Syntax

CoupNum(Arg1Arg2Arg3Arg4)expression.CoupNum (Arg1, Arg2, Arg3, Arg4)

: WorksheetFunction オブジェクトを表す変数。expression A variable that represents a WorksheetFunction object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
Arg1Arg1 必須Required バリアント型Variant 証券の受渡日を指定します。The security's settlement date. 受渡日とは、発行日以降に証券が買い手に引き渡される日付です。The security settlement date is the date after the issue date when the security is traded to the buyer.
Arg2Arg2 必須Required バリアント型Variant 証券の満期日を指定します。The security's maturity date. 満期日とは、証券の支払期日です。The maturity date is the date when the security expires.
Arg3Arg3 必須Required バリアント型Variant 年間の利息支払回数を指定します。The number of coupon payments per year. 年 1 回の場合は 1、年 2 回の場合は 2、四半期ごとの場合は 4 を指定します。For annual payments, frequency = 1; for semiannual, frequency = 2; for quarterly, frequency = 4.
Arg4Arg4 省略可能Optional VariantVariant 計算に使用する基準日数を示す数値を指定します。The type of day count basis to use.

戻り値Return value

倍精度浮動小数点型 (Double)Double

注釈Remarks

重要

日付は、DATE 関数を使って入力するか、他の数式または他の関数の結果を指定します。Dates should be entered by using the DATE function, or as results of other formulas or functions. たとえば、2008 年 5 月 23 日を入力する場合は、DATE (2008,5,23) を使用します。For example, use DATE(2008,5,23) for the 23rd day of May, 2008. 日付を文字列として入力した場合、エラーが発生することがあります。Problems can occur if dates are entered as text.

次に、Arg4 に指定できる値を示します。The following table contains the values used in Arg4.

基準Basis 基準日数 (月/年)Day count basis
0 または省略0 or omitted 30 日/360 日 (NASD 方式)US (NASD) 30/360
1-d1 実際の日数/実際の日数Actual/actual
pbm-22 実際の日数/360 日Actual/360
1/33 実際の日数/365 日Actual/365
2/44 30 日/360 日 (ヨーロッパ方式)European 30/360

Excel では、日付は集計に使用できるようにシリアル値として格納されます。Microsoft Excel stores dates as sequential serial numbers so they can be used in calculations. 既定では、1900 年 1 月 1 日のシリアル値は 1、2008 年 1 月 1 日は 1900 年 1 月 1 日から 39,448 日後であるためシリアル値は 39,448 になります。By default, January 1, 1900 is serial number 1, and January 1, 2008 is serial number 39448 because it is 39,448 days after January 1, 1900. Macintosh 版の Excel では、既定とは異なる日付システムが使用されます。Microsoft Excel for the Macintosh uses a different date system as its default.

注意

Visual Basic for Applications (VBA) では、Excel と異なる方法でシリアル日付が計算されます。Visual Basic for Applications (VBA) calculates serial dates differently than Excel. VBA では、シリアル日付値 1 は 1900 年 1 月 1 日ではなく、1899 年 12 月 31 日に該当します。In VBA, serial number 1 is December 31, 1899, rather than January 1, 1900.

受渡日とは、債券などの証券の売買代金を決済した日付です。The settlement date is the date a buyer purchases a coupon, such as a bond. 満期日とは、証券の支払期日です。The maturity date is the date when a coupon expires. たとえば、2008 年 1 月 1 日に発行された 30 年債券を、発行日の 6 か月後に購入したとします。For example, suppose a 30-year bond is issued on January 1, 2008, and is purchased by a buyer six months later. この債券は、発行日が 2008 年 1 月 1 日、受渡日が 2008 年 7 月 1 日になり、満期日は、発行日の 2008 年 1 月 1 日から 30 年後の 2038 年 1 月 1 日になります。The issue date would be January 1, 2008, the settlement date would be July 1, 2008, and the maturity date would be January 1, 2038, which is 30 years after the January 1, 2008, issue date.

引数に整数以外の値を指定すると、小数点以下が切り捨てられます。All arguments are truncated to integers.

受渡日または満期日に無効な日付をCoupNum 、エラーになります。If settlement or maturity is not a valid date, CoupNum generates an error.

頻度に1、2、4以外の数値を指定すると、エラー CoupNumが返されます。If frequency is any number other than 1, 2, or 4, CoupNum generates an error.

Basis < 0 または basis > 4 の場合、 CoupNumはエラーを生成します。If basis < 0 or if basis > 4, CoupNum generates an error.

受渡日≥満期日でCoupNum場合、エラーになります。If settlement ≥ maturity, CoupNum generates an error.

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.