WorksheetFunction.Rate(Double, Double, Double, Object, Object, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
投資の利率を返します。 Rate メソッドの計算には、反復計算の手法が使用されるため、適切な解が見つからないか、複数の解が同時に見つかることになります。 反復計算を 20 回実行した時点で、計算結果の収束値が 0.0000001 以下にならない場合は、エラー値 #NUM! が返されます。
public double Rate (double Arg1, double Arg2, double Arg3, object Arg4, object Arg5, object Arg6);Public Function Rate (Arg1 As Double, Arg2 As Double, Arg3 As Double, Optional Arg4 As Object, Optional Arg5 As Object, Optional Arg6 As Object) As Doubleパラメーター
- Arg1
- Double
期間: 投資期間全体での支払い回数の合計を指定します。
- Arg2
- Double
Pmt - 支払いは各期間に行われ、年金の有効期間中に変更することはできません。 通常、pmt には元金と利息が含まれますが、その他の手数料や税金は含まれていません。 pmt を省略する場合は、fv 引数を含める必要があります。
- Arg3
- Double
Pv - 現在の値 - 一連の将来の支払いが今価値がある合計金額。
- Arg4
- Object
Fv - 最後の支払いが行われた後に達成する将来の価値、または現金残高。 fv を省略すると、0 と見なされます (たとえば、ローンの将来価値は 0)。
- Arg5
- Object
支払期日: 支払いがいつ行われるかを、数値の 0 または 1 で指定します。省略すると、0 を指定したと見なされます。
- Arg6
- Object
推定値: 利率がおよそどれくらいになるかを推定した値を指定します。
戻り値
注釈
引数 nper、pmt、pv、fv、および type の完全な説明については、 を参照してください Pv(Double, Double, Double, Object, Object)。
| 0 または省略 | 各期の期末 |
| 1 | 各期の期首 |
推定値を省略すると、10% が計算に使用されます。
Rate が収束しない場合は、推測に異なる値を試してください。 推測 が 0 から 1 の間の場合、レートは通常収束します。
推定値と期間を指定するときは、時間的な単位を一致させる必要があります。 たとえば、年利 12% の 4 年ローンを月払いで返済する場合、推定値には 12%/12 = 1 (%) を、また期間には 4*12 = 48 (月) を指定します。 また、これと同じローンを年払いで返済する場合は、推定値に 12 (%)、期間に 4 (年) を指定します。