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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

Financial.vb

Retorna um valor que especifica a taxa de juros por período de uma anuidade.

public static double Rate (double NPer, double Pmt, double PV, double FV = 0, Microsoft.VisualBasic.DueDate Due = Microsoft.VisualBasic.DueDate.EndOfPeriod, double Guess = 0.1);

static member Rate : double * double * double * double * Microsoft.VisualBasic.DueDate * double -> double

Public Function Rate (NPer As Double, Pmt As Double, PV As Double, Optional FV As Double = 0, Optional Due As DueDate = Microsoft.VisualBasic.DueDate.EndOfPeriod, Optional Guess As Double = 0.1) As Double

Parâmetros

NPer

Double

Obrigatórios. O número total de períodos de pagamento na anuidade. Por exemplo, se você efetuar pagamentos mensais de um empréstimo de quatro anos para compra de um carro, esse empréstimo terá um total de 4 * 12 (ou 48) períodos de pagamento.

Pmt

Double

Obrigatórios. O pagamento a ser feito em cada período. Os pagamentos geralmente contêm da entidade de segurança e juros que não são alterados durante a vigência da anuidade.

PV

Double

Obrigatórios. O valor atual, ou o valor de hoje, de uma série de pagamentos ou recebimentos futuros. 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.

FV

Double

Opcional. O valor futuro ou o saldo à vista que você deseja ter depois de fazer o pagamento final. Por exemplo, o valor futuro de um empréstimo é US$ 0, porque esse é o valor após o pagamento final. 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. Se omitida, presume-se que seja 0.

Due

DueDate

Opcional. Objeto do tipo DueDate que especifica quando os pagamentos vencem. 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. Se ela for omitida, DueDate.EndOfPeriod será assumido.

Guess

Double

Opcional. O valor estimado é retornado por Rate. Se omitido, Guess é 0,1 (10 por cento).

Retornos

Double

A taxa de juros por período de uma anuidade.

Exceções

ArgumentException

NPer<= 0.

Exemplos

Este exemplo usa a Rate função para calcular a taxa de juros de um empréstimo dado o número total de pagamentos (TotPmts), o valor do pagamento do empréstimo (Payment), o valor atual ou a entidade de segurança do empréstimo (PVal), o valor futuro do empréstimo (FVal), um número que indica se o pagamento é devido no início ou no final do período de pagamento (PayType), e uma aproximação da taxa de juros esperada (Guess).

Sub TestRate()
    Dim PVal, Payment, TotPmts, APR As Double
    Dim PayType As DueDate

    ' Define percentage format.
    Dim Fmt As String = "##0.00"
    Dim Response As MsgBoxResult
    ' Usually 0 for a loan.
    Dim FVal As Double = 0
    ' Guess of 10 percent.
    Dim Guess As Double = 0.1
    PVal = CDbl(InputBox("How much did you borrow?"))
    Payment = CDbl(InputBox("What's your monthly payment?"))
    TotPmts = CDbl(InputBox("How many monthly payments do you have to make?"))
    Response = MsgBox("Do you make payments at the end of the month?", MsgBoxStyle.YesNo)
    If Response = MsgBoxResult.No Then
        PayType = DueDate.BegOfPeriod
    Else
        PayType = DueDate.EndOfPeriod
    End If
    APR = (Rate(TotPmts, -Payment, PVal, FVal, PayType, Guess) * 12) * 100

    MsgBox("Your interest rate is " & Format(CInt(APR), Fmt) & " percent.")
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.

Rate é calculado por iteração. A partir do valor de , Rate percorre o cálculo até que o resultado seja preciso para dentro de Guess0,00001%. Se Rate não for possível encontrar um resultado após 20 tentativas, ele falhará. Se o seu palpite for 10% e Rate falhar, tente um valor diferente para Guess.

Confira também

• ArgumentException
• Resumo Financeiro