Financial.IRR(Double[], Double) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Financial.vb

Retorna um valor que especifica a taxa interna de retorno de uma série de fluxos de caixa periódicos (pagamentos e recebimentos).

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

Parâmetros

ValueArray

Double[]

Obrigatórios. Matriz de Double que especifica valores de fluxo de caixa. A matriz deve conter, pelo menos, um valor negativo (um pagamento) e um valor positivo (um recebimento).

Guess

Double

Opcional. Um objeto que especifica o valor estimado será retornado pelo IRR. Se omitido, Guess é 0,1 (10 por cento).

Retornos

Double

A taxa interna de retorno de uma série de fluxos de caixa periódicos (pagamentos e recebimentos).

Exceções

ArgumentException

Os valores de argumento de matriz são inválidos ou Guess<= -1.

Exemplos

Neste exemplo, a IRR função retorna a taxa interna de retorno para uma série de cinco fluxos de caixa contidos na matriz Values(). O primeiro elemento de matriz é um fluxo de caixa negativo que representa os custos de inicialização de negócios. Os quatro fluxos de caixa restantes representam fluxos de caixa positivos para os quatro anos seguintes. Guess é a taxa interna estimada de retorno.

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

Comentários

A taxa interna de retorno é a taxa de juros recebida para um investimento que consiste em pagamentos e recibos que ocorrem em intervalos regulares.

A IRR função usa a ordem dos valores dentro da matriz para interpretar a ordem de pagamentos e recibos. Insira os valores de pagamento e recibo na sequência correta. O fluxo de caixa para cada período não precisa ser corrigido, como é para uma anuidade.

IRR é calculado por iteração. Começando com o valor de , IRR percorre o cálculo até que o resultado seja preciso para dentro de Guess0,00001%. Se IRR não for possível encontrar um resultado após 20 tentativas, ele falhará.

Confira também

• NPV(Double, Double[])
• MIRR(Double[], Double, Double)
• ArgumentException
• Resumo Financeiro