Financial.NPer(Double, Double, Double, Double, DueDate) Método
Definição
Retorna um valor que especifica o número de períodos de uma anuidade com base em pagamentos fixos periódicos e em uma taxa de juros fixa.Returns a value specifying the number of periods for an annuity based on periodic fixed payments and a fixed interest rate.
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
Obrigatórios.Required. A taxa de juros por período.The interest rate per period. Por exemplo, se você conseguir um empréstimo para compra de um carro com uma APR (taxa anual de percentual) de 10% e efetuar pagamentos mensais, a taxa por período será de 0,1/12 ou 0,0083.For example, if you get a car loan at an annual percentage rate (APR) of 10 percent and make monthly payments, the rate per period is 0.1/12, or 0.0083.
- Pmt
- Double
Obrigatórios.Required. O pagamento a ser feito em cada período.The payment to be made each period. Os pagamentos normalmente contêm o montante e os juros, que não são alterados durante a vigência da anuidade.Payments usually contain principal and interest that does not change over the life of the annuity.
- PV
- Double
Obrigatórios.Required. O valor atual, ou o valor de hoje, de uma série de pagamentos ou recebimentos futuros.The present value, or value today, of a series of future payments or receipts. Por exemplo, quando você pede um empréstimo para comprar um carro, o valor do empréstimo é o valor atual para o credor dos pagamentos mensais do carro que serão efetuados.For example, when you borrow money to buy a car, the loan amount is the present value to the lender of the monthly car payments you will make.
- FV
- Double
Opcional.Optional. O valor futuro ou o saldo à vista que você deseja ter depois de fazer o pagamento final.The future value or cash balance you want after you have made the final payment. Por exemplo, o valor futuro de um empréstimo é US$ 0, porque esse é o valor após o pagamento final.For example, the future value of a loan is $0 because that is its value after the final payment. No entanto, se você deseja economizar US$ 50.000 durante 18 anos para a educação de seu filho, o valor futuro é de US$ 50.000.However, if you want to save $50,000 over 18 years for your child's education, then $50,000 is the future value. Se omitida, presume-se que seja 0.If omitted, 0 is assumed.
- Due
- DueDate
Opcional.Optional. Objeto do tipo DueDate que especifica quando os pagamentos vencem.Object of type DueDate that specifies when payments are due. Esse argumento deverá ser DueDate.EndOfPeriod se os pagamentos vencerem no final do período de pagamento ou DueDate.BegOfPeriod se os pagamentos vencerem no início do período.This argument must be either DueDate.EndOfPeriod if payments are due at the end of the payment period, or DueDate.BegOfPeriod if payments are due at the beginning of the period. Se omitido, DueDate.EndOfPeriod será suposto.If omitted, DueDate.EndOfPeriod is assumed.
Retornos
O número de períodos de uma anuidade com base em pagamentos fixos periódicos e em uma taxa de juros fixa.The number of periods for an annuity based on periodic fixed payments and a fixed interest rate.
Exceções
Rate = 0 e Pmt = 0Rate = 0 and 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 em PVal .This example uses the NPer function to return the number of periods during which payments must be made to pay off a loan whose value is contained in PVal. Também são fornecidas a taxa de percentual 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 ).Also provided are the interest percentage rate per period (APR / 12), the payment (Payment), the future value of the loan (FVal), and a number that indicates whether the payment is due at the beginning or end of the payment period (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 à vista fixos feitos ao longo de um período de tempo.An annuity is a series of fixed cash payments made over a period of time. Uma anuidade pode ser um empréstimo (como uma hipoteca doméstica) ou um investimento (como um plano de poupança mensal).An annuity can be a loan (such as a home mortgage) or an investment (such as a monthly savings plan).
Para todos os argumentos, o dinheiro pago (como depósitos de economia) é representado por números negativos; o dinheiro recebido (como cheques de dividendos) é representado por números positivos.For all arguments, cash paid out (such as deposits to savings) is represented by negative numbers; cash received (such as dividend checks) is represented by positive numbers.