Financial.IRR(Double[], Double) メソッド

定義

名前空間:
Microsoft.VisualBasic
アセンブリ:
Microsoft.VisualBasic.Core.dll
アセンブリ:
Microsoft.VisualBasic.dll
ソース:
Financial.vb
ソース:
Financial.vb
ソース:
Financial.vb
ソース:
Financial.vb
ソース:
Financial.vb

一連の定期的なキャッシュ フロー (支払と領収書) の内部利益率を指定する値を返します。

public static double IRR(ref double[] ValueArray, double Guess = 0.1);
static member IRR : Double[] * double -> double
Public Function IRR (ByRef ValueArray As Double(), Optional Guess As Double = 0.1) As Double

パラメーター

ValueArray
Double[]

必須。 キャッシュ フロー値を指定する Double の配列。 配列には、少なくとも 1 つの負の値 (支払い) と、1 つの正の値 (受け取り) を含める必要があります。

Guess
Double

このフィールドは省略可能です。 推定した値を指定するオブジェクトは、 IRRによって返されます。 省略すると、 Guess は 0.1 (10%) になります。

返品

Double

一連の定期的なキャッシュ フロー (支払と領収書) の内部利益率。

例外

ArgumentException

配列引数の値が無効であるか、 Guess< = -1 です。

例

この例では、 IRR 関数は、配列 Values()に含まれる一連の 5 つのキャッシュ フローの内部利益率を返します。 最初の配列要素は、ビジネスのスタートアップ コストを表す負のキャッシュ フローです。 残りの 4 つのキャッシュ フローは、その後の 4 年間のプラスのキャッシュ フローを表します。 Guess は、推定内部収益率です。

' Define money format.
Dim MoneyFmt As String = "###,##0.00"
' Define percentage format.
Dim PercentFmt As String = "#0.00"

Dim values(4) As Double
' Business start-up costs.
values(0) = -70000
' Positive cash flows reflecting income for four successive years.
values(1) = 22000
values(2) = 25000
values(3) = 28000
values(4) = 31000

' Use the IRR function to calculate the rate of return.
' Guess starts at 10 percent.
Dim Guess As Double = 0.1
' Calculate internal rate.
Dim CalcRetRate As Double = IRR(values, Guess) * 100
' Display internal return rate.
MsgBox("The internal rate of return for these cash flows is " & 
    Format(CalcRetRate, CStr(PercentFmt)) & " percent.")

注釈

内部利益率は、定期的に発生する支出と収入から構成される投資に対して受け取る金利です。

IRR関数は、配列内の値の順序を使用して、支払いと領収書の順序を解釈します。 支出値と収入値は、正しい順序で入力してください。 各期間のキャッシュ フローは、年金の場合と同様に固定する必要はありません。

IRR はイテレーションによって計算されます。 Guessの値から始めて、IRRは、結果が 0.00001% 以内に正確になるまで計算を循環します。 IRR 20 回試行しても結果が見つからない場合は失敗します。

適用対象

こちらもご覧ください