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

投資の利率を返します。Returns the interest rate per period of an annuity. Rateは反復計算によって計算され、0個以上のソリューションを含めることができます。Rate is calculated by iteration and can have zero or more solutions. 20回反復した後に、 rateの連続する結果が0.0000001 以内に収束しない場合、 rateは #NUM を返します。If the successive results of Rate do not converge to within 0.0000001 after 20 iterations, Rate returns the #NUM! が返されます。error value.

構文Syntax

利率(Arg1Arg2Arg3Arg4Arg5Arg6)expression.Rate (Arg1, Arg2, Arg3, Arg4, Arg5, Arg6)

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

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
Arg1Arg1 必須Required DoubleDouble 期間: 投資期間全体での支払い回数の合計を指定します。Nper - the total number of payment periods in an annuity.
Arg2Arg2 必須Required DoubleDouble Pmt-各期間に行われた支払額で、投資期間を通じて変更することはできません。Pmt - the payment made each period and cannot change over the life of the annuity. 通常、pmt にはプリンシパルと利息が含まれますが、他の料金や税金はありません。Typically, pmt includes principal and interest but no other fees or taxes. Pmt が省略された場合は、fv 引数を含める必要があります。If pmt is omitted, you must include the fv argument.
Arg3Arg3 必須Required DoubleDouble 現在価値-現在の—値は、将来行われる一連の支払いを現時点での合計金額です。Pv - the present value—the total amount that a series of future payments is worth now.
Arg4Arg4 省略可能Optional VariantVariant Fv-将来価値、または最後の支払いを行った後に残る現金の収支を指定します。Fv - the future value, or a cash balance you want to attain after the last payment is made. Fv を省略すると、0を指定したと見なされます (たとえば、ローンの将来価値は0になります)。If fv is omitted, it is assumed to be 0 (the future value of a loan, for example, is 0).
Arg5Arg5 省略可能Optional VariantVariant Type-数字0または1を指定します。支払いの期日を示します。Type - the number 0 or 1; indicates when payments are due.
Arg6Arg6 省略可能Optional VariantVariant 推定値: 利率がおよそどれくらいになるかを推定した値を指定します。Guess - your guess for what the rate will be.

戻り値Return value

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

注釈Remarks

引数 nper、pmt、pv、fv、および型の完全な説明については、 pv を参照してください。For a complete description of the arguments nper, pmt, pv, fv, and type, see Pv.

次に、 Arg5 に指定できる値を示します。The following table describes the values that can be used for Arg5.

支払期日Set type equal to 支払いが行われる時期If payments are due
0 または省略0 or omitted 各期の期末At the end of the period
1-d1 各期の期首At the beginning of the period

推定値を省略すると、10% が計算に使用されます。If you omit guess, it is assumed to be 10 percent.

Rateが収束していない場合は、推定値を変更してください。If Rate does not converge, try different values for guess. **** 推定値が0から1の間の場合は、通常は収束します。Rate usually converges if guess is between 0 and 1.

推定値と期間を指定するために使用する単位について一貫性があることを確認してください。Make sure that you are consistent about the units that you use for specifying guess and nper. たとえば、年利 12% の 4 年ローンを月払いで返済する場合、推定値には 12%/12 = 1 (%) を、また期間には 4*12 = 48 (月) を指定します。If you make monthly payments on a four-year loan at 12 percent annual interest, use 12%/12 for guess and 4*12 for nper. また、これと同じローンを年払いで返済する場合は、推定値に 12 (%)、期間に 4 (年) を指定します。If you make annual payments on the same loan, use 12% for guess and 4 for nper.

サポートとフィードバック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.