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

Definição

Retorna um valor que especifica o valor líquido atual de um investimento com base em uma série de fluxos de caixa periódicos (pagamentos e recebimentos) e em uma taxa de desconto.Returns a value specifying the net present value of an investment based on a series of periodic cash flows (payments and receipts) and a discount rate.

public:
 static double NPV(double Rate, cli::array <double> ^ % ValueArray);
public static double NPV (double Rate, ref double[] ValueArray);
static member NPV : double * Double[] -> double
Public Function NPV (Rate As Double, ByRef ValueArray As Double()) As Double

Parâmetros

Rate
Double

Obrigatórios.Required. A taxa de desconto durante o período, expressa como um decimal.The discount rate over the length of the period, expressed as a decimal.

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

Retornos

Double

O valor líquido atual de um investimento com base em uma série de fluxos de caixa periódicos (pagamentos e recebimentos) e em uma taxa de desconto.The net present value of an investment based on a series of periodic cash flows (payments and receipts) and a discount rate.

Exceções

ValueArrayé Nothing , Rank de ValueArray < > 1, ou Rate =-1ValueArray is Nothing, rank of ValueArray <> 1, or Rate = -1

Exemplos

Este exemplo usa a NPV função para retornar o valor presente líquido para uma série de fluxos de caixa contidos na matriz values() .This example uses the NPV function to return the net present value for a series of cash flows contained in the array values(). O valor de retorno, armazenado em FixedRetRate , representa a taxa interna fixa de retorno.The return value, stored in FixedRetRate, represents the fixed 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 NPV function to calculate the net present value.
' Set fixed internal rate.
Dim FixedRetRate As Double = 0.0625
' Calculate net present value.
Dim NetPVal As Double = NPV(FixedRetRate, values)
' Display net present value.
MsgBox("The net present value of these cash flows is " & 
    Format(NetPVal, MoneyFmt) & ".")

Comentários

O valor líquido presente de um investimento é o valor atual de uma série futura de pagamentos e recebimentos.The net present value of an investment is the current value of a future series of payments and receipts.

A NPV função usa a ordem dos valores dentro da matriz para interpretar a ordem de pagamentos e recebimentos.The NPV 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 NPV investimento começa um período antes da data do primeiro valor de fluxo de caixa e termina com o último valor de fluxo de caixa na matriz.The NPV investment begins one period before the date of the first cash flow value and ends with the last cash flow value in the array.

O cálculo do valor presente líquido é baseado em fluxos de caixa futuros.The net present value calculation is based on future cash flows. Se seu primeiro fluxo de caixa ocorrer no início do primeiro período, o primeiro valor deverá ser adicionado ao valor retornado por NPV e não deve ser incluído nos valores de fluxo de caixa de ValueArray .If your first cash flow occurs at the beginning of the first period, the first value must be added to the value returned by NPV and must not be included in the cash flow values of ValueArray.

A NPV função é semelhante à PV função (valor presente), exceto que a PV função permite que os fluxos de caixa comecem no final ou no início de um ponto.The NPV function is similar to the PV function (present value) except that the PV function allows cash flows to begin either at the end or the beginning of a period. Ao contrário dos valores da variável de NPV fluxo de caixa, PV os fluxos de caixa devem ser corrigidos em todo o investimento.Unlike the variable NPV cash flow values, PV cash flows must be fixed throughout the investment.

Aplica-se a

Confira também