Financial.IRR(Double[], Double) Método
Definição
Retorna um valor que especifica a taxa interna de retorno de uma série de fluxos de caixa periódicos (pagamentos e recebimentos).Returns a value specifying the internal rate of return for a series of periodic cash flows (payments and receipts).
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.Required. Matriz de Double que especifica valores de fluxo de caixa.Array of Double specifying cash flow values. A matriz deve conter, pelo menos, um valor negativo (um pagamento) e um valor positivo (um recebimento).The array must contain at least one negative value (a payment) and one positive value (a receipt).
- Guess
- Double
Opcional.Optional. Um objeto que especifica o valor estimado será retornado pelo IRR.Object specifying value you estimate will be returned by IRR. Se omitido, Guess é 0,1 (10 por cento).If omitted, Guess is 0.1 (10 percent).
Retornos
A taxa interna de retorno de uma série de fluxos de caixa periódicos (pagamentos e recebimentos).The internal rate of return for a series of periodic cash flows (payments and receipts).
Exceções
Os valores de argumento de matriz são inválidos ou Guess < =-1.Array argument values are invalid or 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() .In this example, the IRR function returns the internal rate of return for a series of five cash flows contained in the array Values(). O primeiro elemento de matriz é um fluxo de caixa negativo que representa os custos de inicialização dos negócios.The first array element is a negative cash flow representing business start-up costs. Os quatro fluxos de caixa restantes representam fluxos de caixa positivos para os quatro anos subsequentes.The remaining four cash flows represent positive cash flows for the subsequent four years. Guess é a taxa interna estimada de retorno.Guess is the estimated internal rate of return.
' 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 recebimentos que ocorrem em intervalos regulares.The internal rate of return is the interest rate received for an investment consisting of payments and receipts that occur at regular intervals.
A IRR função usa a ordem dos valores dentro da matriz para interpretar a ordem de pagamentos e recebimentos.The IRR function uses the order of values within the array to interpret the order of payments and receipts. Certifique-se de inserir seus valores de pagamento e de recebimento na sequência correta.Be sure to enter your payment and receipt values in the correct sequence. O fluxo de caixa para cada período não precisa ser corrigido, pois é para uma anuidade.The cash flow for each period does not need to be fixed, as it is for an annuity.
IRR é calculado por iteração.IRR is calculated by iteration. Começando com o valor de Guess , IRR percorre o cálculo até que o resultado seja preciso dentro de 0, 1%.Starting with the value of Guess, IRR cycles through the calculation until the result is accurate to within 0.00001 percent. Se IRR o não puder encontrar um resultado após 20 tentativas, ele falhará.If IRR cannot find a result after 20 tries, it fails.