WorksheetFunction.YieldMat メソッド (Excel)

満期日に利息が支払われる証券の利回りを返します。

構文

式。YieldMat (Arg1, Arg2, Arg3, Arg4, Arg5, Arg6)

式: WorksheetFunction オブジェクトを表す変数。

パラメーター

名前	必須 / オプション	データ型	説明
Arg1	必須	バリアント型 (Variant)	受渡日: 証券の受渡日を指定します。 受渡日とは、発行日以降に証券が買い手に引き渡される日付です。
Arg2	必須	バリアント型 (Variant)	満期日: 証券の満期日を指定します。 満期日とは、証券の支払期日です。
Arg3	必須	バリアント型 (Variant)	発行日: 証券の発行日を指定します。日付にはシリアル値が使用されます。
Arg4	必須	バリアント型 (Variant)	利率: 発行日の証券の利率を指定します。
Arg5	必須	バリアント型 (Variant)	現在価値: 額面 $ 100 に対する証券の価値を指定します。
Arg6	省略可能	バリアント型 (Variant)	基準: 計算に使用する基準日数を示す数値を指定します。

戻り値

Double

注釈

重要

日付は、DATE 関数を使って入力するか、他の数式または他の関数の結果を指定します。 たとえば、2008 年 5 月 23 日を入力する場合は、DATE (2008,5,23) を使用します。 日付を文字列として入力した場合、エラーが発生することがあります。

次の表では、 Arg6 に使用できる値について説明します。

基礎	基準日数 (月/年)
0 または省略	30 日/360 日 (NASD 方式)
1	実際の日数/実際の日数
2	実際の日数/360 日
3	実際の日数/365 日
4	30 日/360 日 (ヨーロッパ方式)

Excel では、日付は集計に使用できるようにシリアル値として格納されます。 既定では、1900 年 1 月 1 日のシリアル値は 1、2008 年 1 月 1 日は 1900 年 1 月 1 日から 39,448 日後であるためシリアル値は 39,448 になります。 Macintosh 用の Microsoft Excel では、既定として別の日付システムが使用されます。

注:

Visual Basic for Applications (VBA) では、Excel と異なる方法でシリアル日付が計算されます。 VBA では、シリアル日付値 1 は 1900 年 1 月 1 日ではなく、1899 年 12 月 31 日に該当します。

受渡日とは、債券などの証券の売買代金を決済した日付です。 満期日とは、証券の支払期日です。 たとえば、2008 年 1 月 1 日に発行された 30 年債券を、発行日の 6 か月後に購入したとします。 この債券は、発行日が 2008 年 1 月 1 日、受渡日が 2008 年 7 月 1 日になり、満期日は、発行日の 2008 年 1 月 1 日から 30 年後の 2038 年 1 月 1 日になります。

受渡日、満期日、発行日、基準に整数以外の値を指定すると、小数点以下が切り捨てられます。

決済、満期日、または発行が有効な日付でない場合、 YieldMat は #VALUEを返します。 が返されます。

レート < 0 の場合、または pr ≤ 0 の場合、 YieldMat は #NUMを返します。 が返されます。

基準 < 0 の場合、または基準 > 4 の場合、 YieldMat は #NUMを返します。 が返されます。

決済が満期日≥場合、 YieldMat は #NUMを返します。 が返されます。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。