Partager via


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

Définition

Retourne une valeur indiquant le taux d’intérêt par échéance pour une annuité.

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

Paramètres

NPer
Double

Obligatoire. Nombre total d’échéances de l’annuité. Par exemple, si vous effectuez des remboursements mensuels dans le cadre d'un emprunt d'une durée de quatre ans, votre emprunt comporte un total de 4 * 12 (soit 48) échéances.

Pmt
Double

Obligatoire. Versement à effectuer à chaque échéance. Les paiements comprennent généralement le capital et les intérêts qui ne sont pas modifiés au cours de l'annuité.

PV
Double

Obligatoire. Valeur actuelle, ou valeur du jour, d’une série de paiements ou d’encaissements futurs. Par exemple, lorsque vous empruntez de l'argent pour acheter une voiture, le montant du prêt correspond pour le prêteur à la valeur actuelle des remboursements mensuels que vous allez effectuer pour la voiture.

FV
Double

Optionnel. Valeur future ou solde de caisse souhaité au terme du dernier remboursement. Par exemple, la valeur future d'un emprunt est de 0 €, car il s'agit de sa valeur après le dernier remboursement. Toutefois, si vous souhaitez économiser 50 000 € sur 18 ans pour les études de votre enfant, ce montant constitue la valeur future. Si cet argument est omis, la position 0 est utilisée par défaut.

Due
DueDate

Optionnel. Objet de type DueDate qui spécifie la date d'échéance des paiements. Cet argument doit avoir la valeur DueDate.EndOfPeriod si les paiements sont dus à terme échu ou DueDate.BegOfPeriod si les paiements sont dus à terme à échoir. En cas d'omission, DueDate.EndOfPeriod est utilisé.

Guess
Double

Optionnel. Valeur que vous estimez être retournée par Rate. Si cet argument est omis, la valeur Guess 0,1 (10 pour cent) est utilisée par défaut.

Retours

Taux d’intérêt par échéance pour une annuité.

Exceptions

NPer<= 0.

Exemples

Cet exemple utilise la Rate fonction pour calculer le taux d’intérêt d’un prêt en fonction du nombre total de paiements (TotPmts), du montant du paiement du prêt (Payment), de la valeur actuelle ou du principal du prêt (PVal), de la valeur future du prêt (FVal), un nombre qui indique si le paiement est dû au début ou à la fin de la période de paiement (PayType), et une approximation du taux d’intérêt attendu (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

Remarques

Une rente est une série de paiements fixes en espèces effectués sur une période de temps. Une rente peut être un prêt (comme un prêt hypothécaire) ou un investissement (par exemple, un plan d’épargne mensuel).

Pour tous les arguments, les espèces versées (par exemple, les dépôts à l’épargne) sont représentées par des nombres négatifs ; les espèces reçues (par exemple, les chèques de dividende) sont représentées par des nombres positifs.

Rate est calculé par itération. À compter de la valeur de Guess, Rate effectue un cycle de calcul jusqu’à ce que le résultat soit précis à 0,00001 %. S’il Rate ne parvient pas à trouver un résultat après 20 tentatives, il échoue. Si votre estimation est de 10 % et Rate échoue, essayez une autre valeur pour Guess.

S’applique à

Voir aussi