Financial.Rate, méthode
Retourne une valeur de type Double indiquant le taux d'intérêt par échéance pour une annuité.
Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)
Syntaxe
'Déclaration
Public Shared Function Rate ( _
NPer As Double, _
Pmt As Double, _
PV As Double, _
<OptionalAttribute> Optional FV As Double = 0, _
<OptionalAttribute> Optional Due As DueDate = DueDate.EndOfPeriod, _
<OptionalAttribute> Optional Guess As Double = 0.1 _
) As Double
'Utilisation
Dim NPer As Double
Dim Pmt As Double
Dim PV As Double
Dim FV As Double
Dim Due As DueDate
Dim Guess As Double
Dim returnValue As Double
returnValue = Financial.Rate(NPer, Pmt, PV, FV, Due, Guess)
public static double Rate (
double NPer,
double Pmt,
double PV,
[OptionalAttribute] double FV,
[OptionalAttribute] DueDate Due,
[OptionalAttribute] double Guess
)
public:
static double Rate (
double NPer,
double Pmt,
double PV,
[OptionalAttribute] double FV,
[OptionalAttribute] DueDate Due,
[OptionalAttribute] double Guess
)
public static double Rate (
double NPer,
double Pmt,
double PV,
/** @attribute OptionalAttribute() */ double FV,
/** @attribute OptionalAttribute() */ DueDate Due,
/** @attribute OptionalAttribute() */ double Guess
)
public static function Rate (
NPer : double,
Pmt : double,
PV : double,
FV : double,
Due : DueDate,
Guess : double
) : double
Paramètres
- NPer
Obligatoire. Double spécifie le 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
Obligatoire. Double indique le 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
Obligatoire. Double indique la valeur actuelle, ou valeur d'aujourd'hui, 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
Facultatif. Double spécifie la valeur future ou le 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
Facultatif. Objet de type énumeration DueDate qui spécifie la date d'échéance des paiements. Cet argument doit avoir la valeurDueDate.EndOfPeriodsi les paiements sont dus à terme échu ouDueDate.BegOfPeriodsi les paiements sont dus à terme à échoir. En cas d'omission,DueDate.EndOfPeriodest utilisé par défaut.
- Guess
Facultatif. Double spécifiant la valeur que vous estimez est retourné par Rate. Si cet argument est omis, la valeur Guess 0,1 (10 pour cent) est utilisée par défaut.
Valeur de retour
Retourne une valeur de type Double indiquant le taux d'intérêt par échéance pour une annuité.
Notes
Pour plus d'informations, consultez la rubrique Visual Basic Rate, fonction.
Une annuité est une série de versements constants effectués sur une certaine période. Il peut s'agir d'un prêt (pour l'achat d'une maison, par exemple) ou d'un placement (tel qu'un plan d'épargne sur lequel de l'argent est versé chaque mois).
Pour tous les arguments, les sommes versées (telles que les dépôts sur un compte épargne) sont représentées par des nombres négatifs ; les sommes reçues (telles que les distributions de dividendes) sont représentées par des nombres positifs.
Rate est calculé par itération. En commençant par la valeur de l'argument Guess, la fonction Rate répète le cycle de calcul jusqu'à ce que le résultat soit précis à 0,00001 % près. La fonction Rate échoue si elle n'a pas pu trouver de résultat après 20 tentatives. Si votre estimation est de 10 % et si la fonction Rate échoue, essayez d'attribuer une valeur différente à l'argument Guess.
Exemple
Cet exemple utilise la fonction Rate pour calculer le taux d'intérêt d'un emprunt, en fonction du nombre d'échéances (TotPmts), du montant des remboursements (Payment), de la valeur actuelle ou du capital de l'emprunt (PVal), de la valeur future de l'emprunt (FVal), d'un nombre indiquant si le paiement doit être effectué en début ou en fin de période (PayType), ainsi que de la valeur approximative du taux d'intérêt escompté (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
Plates-formes
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Informations de version
.NET Framework
Prise en charge dans : 2.0, 1.1, 1.0
.NET Compact Framework
Prise en charge dans : 2.0, 1.0
Voir aussi
Référence
Financial, classe
Membres Financial
Microsoft.VisualBasic, espace de noms
ArgumentException