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

Definição

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

Devolve um valor que especifica a taxa de juro por período para 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

Required. O número total de períodos de pagamento na anuidade. Por exemplo, se fizer pagamentos mensais num empréstimo automóvel de 4 anos, o seu empréstimo tem um total de 4 * 12 (ou 48) períodos de pagamento.

Pmt
Double

Required. O pagamento a ser feito em cada período. Normalmente, os pagamentos contêm capital e juros que não mudam ao longo 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 de caixa 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.

Guess
Double

Optional. O valor que estima é devolvido por Rate. Se omitido, Guess é 0,1 (10 por cento).

Devoluções

Double

A taxa de juro por período para uma anuidade.

Exceções

ArgumentException

NPer <= 0.

Exemplos

Este exemplo utiliza a Rate função para calcular a taxa de juro de um empréstimo dado o número total de pagamentos (TotPmts), o montante do pagamento do empréstimo (Payment), o valor presente ou principal 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 fim do período de pagamento (PayType), e uma aproximação da taxa de juro 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

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.

Rate é calculado por iteração. Começando pelo valor de Guess, Rate percorre o cálculo até que o resultado seja preciso dentro de 0,00001 por cento. Se Rate não conseguir encontrar um resultado após 20 tentativas, falha. Se a sua estimativa for 10 por cento e Rate falhar, tente um valor diferente para Guess.

Aplica-se a

Ver também