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

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Source:
Financial.vb
Source:
Financial.vb
Source:
Financial.vb
Source:
Financial.vb
Source:
Financial.vb

Retourne une valeur spécifiant le taux d’intérêt par période 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 de périodes de paiement dans l’annuité. Par exemple, si vous effectuez des paiements mensuels sur un prêt auto de quatre ans, votre prêt a un total de 4 * 12 (ou 48) périodes de paiement.

Pmt
Double

Obligatoire. Paiement à effectuer chaque période. Paiements contiennent généralement le principal et l’intérêt qui ne changent pas pendant la durée de la rente.

PV
Double

Obligatoire. Valeur actuelle, ou valeur actuelle, d’une série de paiements ou de reçus futurs. Par exemple, lorsque vous empruntez de l’argent pour acheter une voiture, le montant du prêt est la valeur actuelle pour le prêteur des paiements mensuels de voiture que vous allez faire.

FV
Double

Optional. Valeur future ou solde de trésorerie souhaité après avoir effectué le paiement final. Par exemple, la valeur future d’un prêt est \$0, car c’est sa valeur après le paiement final. Toutefois, si vous souhaitez économiser 50 000 $ sur 18 ans pour l’éducation de votre enfant, \50 000 $ est la valeur future. En cas d’omission, 0 est supposé.

Due
DueDate

Optional. Objet de type DueDate qui spécifie quand les paiements sont dûs. Cet argument doit être soit DueDate.EndOfPeriod si les paiements sont dûs à la fin de la période de paiement, soit DueDate.BegOfPeriod si les paiements sont dus au début de la période. En cas d’omission, DueDate.EndOfPeriod est supposé.

Guess
Double

Optional. La valeur que vous estimez est retournée par Rate. S’il est omis, Guess est de 0,1 (10 pour cent).

Retours

Double

Taux d’intérêt par période pour une rente.

Exceptions

ArgumentException

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), d’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 annuité est une série de paiements en espèces fixes effectués sur une période donnée. Une annuité peut être un prêt (par exemple, une hypothèque d’habitation) ou un investissement (par exemple, un plan d’épargne mensuel).

Pour tous les arguments, l’argent versé (comme les dépôts sur l’épargne) est représenté par des nombres négatifs ; l’argent reçu (comme les chèques de dividendes) est représenté par des chiffres 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 dans un délai de 0,00001 %. Si Rate aucun résultat n’est trouvé après 20 tentatives, il échoue. Si votre estimation est de 10 % et Rate échoue, essayez une valeur différente pour Guess.

S’applique à

Voir aussi