Financial.NPer(Double, Double, Double, Double, DueDate) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve um valor que especifica o número de períodos para uma anuidade com base em pagamentos fixos periódicos e uma taxa de juro fixa.

public static double NPer(double Rate, double Pmt, double PV, double FV = 0, Microsoft.VisualBasic.DueDate Due = Microsoft.VisualBasic.DueDate.EndOfPeriod);
static member NPer : double * double * double * double * Microsoft.VisualBasic.DueDate -> double
Public Function NPer (Rate As Double, Pmt As Double, PV As Double, Optional FV As Double = 0, Optional Due As DueDate = Microsoft.VisualBasic.DueDate.EndOfPeriod) As Double

Parâmetros

Rate
Double

Required. A taxa de juro por período. Por exemplo, se obter um empréstimo automóvel a uma taxa percentual anual (APR) de 10 por cento e efetuar pagamentos mensais, a taxa por período é 0,1/12 ou 0,0083.

Pmt
Double

Required. O pagamento a ser feito em cada período. Os pagamentos geralmente contêm capital e juros que não mudam ao longo da vida da anuidade.

PV
Double

Required. O valor presente, ou valor atual, de uma série de pagamentos ou receitas futuras. Por exemplo, quando pede dinheiro emprestado para comprar um carro, o valor do empréstimo é o valor atual para o credor dos pagamentos mensais de carros que vai fazer.

FV
Double

Optional. O valor futuro ou saldo em dinheiro que pretende depois de efetuar o pagamento final. Por exemplo, o valor futuro de um empréstimo é \$0 porque esse é o seu valor após o pagamento final. No entanto, se quiser poupar $50.000 ao longo de 18 anos para a educação do seu filho, então \$50.000 é o valor futuro. Se for omitido, é assumido 0.

Due
DueDate

Optional. Objeto de tipo DueDate que especifica quando os pagamentos são devidos. Este argumento deve ser ou DueDate.EndOfPeriod se os pagamentos forem devidos no final do período de pagamento, ou DueDate.BegOfPeriod se os pagamentos forem devidos no início do período. Se for omitido, DueDate.EndOfPeriod assume-se.

Devoluções

Double

O número de períodos para uma anuidade baseado em pagamentos fixos periódicos e uma taxa de juro fixa.

Exceções

ArgumentException

Rate = 0 e Pmt = 0

Exemplos

Este exemplo utiliza a NPer função para devolver o número de períodos durante os quais os pagamentos devem ser feitos para pagar um empréstimo cujo valor está contido em PVal. Também são fornecidas a taxa de percentagem de juros por período (APR / 12), o pagamento (Payment), o valor futuro do empréstimo (FVal) e um número que indica se o pagamento é devido no início ou no fim do período de pagamento (PayType).

Sub TestNPer()
    Dim TotPmts As Double
    Dim PVal, APR, Payment As Double
    Dim PayType As DueDate
    Dim Response As MsgBoxResult

    ' Usually 0 for a loan.
    Dim Fval As Double = 0
    PVal = CDbl(InputBox("How much do you want to borrow?"))
    APR = CDbl(InputBox("What is the annual percentage rate of your loan?"))
    ' Usually 0 for a loan.
    If APR > 1 Then APR = APR / 100
    Payment = CDbl(InputBox("How much do you want to pay each month?"))
    Response = MsgBox("Do you make payments at the end of month?", MsgBoxStyle.YesNo)
    If Response = MsgBoxResult.No Then
        PayType = DueDate.BegOfPeriod
    Else
        PayType = DueDate.EndOfPeriod
    End If
    TotPmts = NPer(APR / 12, -Payment, PVal, FVal, PayType)
    If Int(TotPmts) <> TotPmts Then TotPmts = Int(TotPmts) + 1

    MsgBox("It will take you " & TotPmts & " months to pay off your loan.")
End Sub

Observações

Uma anuidade é uma série de pagamentos fixos em dinheiro efetuados durante um período de tempo. Uma anuidade pode ser um empréstimo (como uma hipoteca de casa) ou um investimento (como um plano de poupanças mensal).

Para todos os argumentos, o numerário pago (tal como depósitos em poupanças) é representado por números negativos e o dinheiro recebido (tal como cheques de dividendos) é representado por números positivos.

Aplica-se a

Ver também