Financial.IRR(Double[], Double) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
A taxa interna de retorno de uma série de fluxos de caixa periódicos (pagamentos e recebimentos).
Exceções
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 Guess
0,00001%. Se IRR
não for possível encontrar um resultado após 20 tentativas, ele falhará.