共用方式為


Financial.IRR 方法

傳回 Double,指定一系列的定期現金流量 (付款及收到的款項) 之實質報酬率。

命名空間: Microsoft.VisualBasic
組件: Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function IRR ( _
    ByRef ValueArray As Double(), _
    <OptionalAttribute> Optional Guess As Double = 0.1 _
) As Double
'用途
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
)
public:
static double IRR (
    array<double>^% ValueArray, 
    [OptionalAttribute] double Guess
)
public static double IRR (
    /** @ref */ double[] ValueArray, 
    /** @attribute OptionalAttribute() */ double Guess
)
JScript 並不支援以參考方式來傳遞實值型別的引數。

參數

  • ValueArray
    必要項。指定現金流量值的 Double 陣列;這個陣列至少必須含有一項負值 (付款) 和一項正值 (收款)。
  • Guess
    選擇項。指定您預估值的物件將會由 IRR 所傳回。如果省略,則 Guess 會是 0.1 (百分之 10)。

傳回值

傳回 Double,指定一系列的定期現金流量 (付款及收到的款項) 之實質報酬率。

備註

如需詳細資訊,請參閱 Visual Basic 的主題 IRR 函式

實質報酬率為由固定期間所發生的付款和收款所組成的投資所收到的利率。

IRR 函式會使用陣列中的值順序,解譯付款和收款的順序;請務必依照正確的順序來輸入付款和收款的值。每一期的現金流量不需要固定,因為這是用於年金。

IRR 是由反覆計算得來。以 Guess 值為起始,IRR 會不斷循環計算,直到結果的精確度在 0.00001% 以內為止。如果 IRR 在嘗試 20 次之後仍找不到結果,則會失敗。

範例

在這個範例中,IRR 函式會針對 Values() 陣列內所含的一系列的五筆現金流量傳回實質報酬率。第一個陣列元素是表示企業開始成本的負數現金流量,而其餘的四筆現金流量則表示接下來四年的正數現金流量,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.")

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊,請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本:2.0、1.1、1.0

.NET Compact Framework

支援版本:2.0、1.0

請參閱

參考

Financial 類別
Financial 成員
Microsoft.VisualBasic 命名空間
ArgumentException

其他資源

IRR 函式
NPV 函式
MIRR 函式
財務摘要