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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Financial.vb

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.

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. A taxa de desconto durante o período, expressa como um decimal.

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

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.

Exceções

ArgumentException

ValueArray é Nothing, classificação de ValueArray<> 1 ou 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(). O valor retornado, armazenado em FixedRetRate, representa a taxa interna fixa 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 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 presente líquido de um investimento é o valor atual de uma série futura de pagamentos e recibos.

A NPV 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 NPV investimento começa um período antes da data do primeiro valor do fluxo de caixa e termina com o último valor de fluxo de caixa na matriz.

O cálculo do valor presente líquido baseia-se em fluxos de caixa futuros. Se o 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 deverá ser incluído nos valores de fluxo de caixa de ValueArray.

A NPV função é semelhante à PV função (valor presente), exceto que a função permite que os PV fluxos de caixa comecem no final ou no início de um período. Ao contrário dos valores variáveis NPV de fluxo de caixa, PV os fluxos de caixa devem ser corrigidos durante todo o investimento.

Confira também

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