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

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Origem:
Financial.vb
Origem:
Financial.vb
Origem:
Financial.vb
Origem:
Financial.vb
Origem:
Financial.vb

Retorna um valor que especifica o número de períodos para uma anuidade com base em pagamentos fixos periódicos e uma taxa de juros 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 juros por período. Por exemplo, se você receber um empréstimo de carro a uma taxa percentual anual (APR) de 10% e fazer pagamentos mensais, a taxa por período será de 0,1/12 ou 0,0083.

Pmt
Double

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

PV
Double

Required. O valor atual, ou valor atual, de uma série de pagamentos ou recibos futuros. Por exemplo, quando você pega dinheiro emprestado para comprar um carro, o valor do empréstimo é o valor presente para o credor dos pagamentos mensais do carro que você fará.

FV
Double

Optional. O valor futuro ou saldo em caixa que você deseja depois de fazer 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 você quiser economizar \$50.000 em 18 anos para a educação do seu filho, então \$50.000 é o valor futuro. Se omitido, 0 será assumido.

Due
DueDate

Optional. Objeto do tipo DueDate que especifica quando os pagamentos são vencidos. Esse argumento deve ser DueDate.EndOfPeriod se os pagamentos forem vencidos no final do período de pagamento ou DueDate.BegOfPeriod se os pagamentos forem vencidos no início do período. Se omitido, DueDate.EndOfPeriod será assumido.

Retornos

Double

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

Exceções

ArgumentException

Rate = 0 e Pmt = 0

Exemplos

Este exemplo usa a NPer função para retornar o número de períodos durante os quais os pagamentos devem ser feitos para pagar um empréstimo cujo valor está contido 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

Comentários

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

Para todos os argumentos, o dinheiro pago (como depósitos na poupança) é representado por números negativos; o dinheiro recebido (como cheques de dividendos) é representado por números positivos.

Aplica-se a

Confira também