Financial.IRR メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Financial.IRR メソッド

一連の定期的なキャッシュフロー (支払いと受け取り) の内部利益率を指定する Double 型の値を返します。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function IRR
 ( _
    ByRef ValueArray As Double(),
 _
    <OptionalAttribute> Optional Guess As
 Double = 0.1 _
) As Double

Visual Basic (使用法)

Dim ValueArray As Double()
Dim Guess As Double
Dim returnValue As Double

returnValue = Financial.IRR(ValueArray, Guess)

public static double IRR (
    ref double[] ValueArray,
    [OptionalAttribute] double Guess
)

C++

public:
static double IRR (
    array<double>^% ValueArray, 
    [OptionalAttribute] double Guess
)

public static double IRR (
    /** @ref */ double[] ValueArray, 
    /** @attribute OptionalAttribute() */ double Guess
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

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

Guess: 省略可能。IRR 関数によって返される推定値を示すオブジェクト。省略した場合、Guess に 0.1 (10%) を指定したものと見なされます。

戻り値
一連の定期的なキャッシュフロー (支払いと受け取り) の内部利益率を指定する Double 型の値を返します。

解説

詳細については、Visual Basic のトピック「IRR 関数」を参照してください。

内部利益率とは、一定間隔で発生する支払いと受け取りから成る投資の受け取り利率です。

IRR 関数では、配列で指定した値の順序がキャッシュフローの順序であると見なされます。支払い額と受け取り額を入力するときは、その順序に注意してください。各期のキャッシュフローは、投資のキャッシュフローのように定額である必要はありません。

IRR は、反復計算の手法を用いて計算されます。Guess の値を初期値とし、IRR は計算結果の誤差が 0.00001% 以内になるまで反復計算を行います。IRR 反復計算を 20 回行っても適切な解が見つからない場合は、エラーとなります。

使用例

この例では、IRR 関数を使用して、配列 Values() に指定した 5 つのキャッシュフローに対する内部利益率を返します。最初の配列要素は、事業の操業資金を表す負のキャッシュフローです。他の 4 つのキャッシュフローは、以後 4 年間の正のキャッシュフローを表しています。Guess には、内部利益率の推定値を指定します。

Visual Basic

' 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.")