Financial.NPer(Double, Double, Double, Double, DueDate) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een waarde die het aantal perioden voor een annuïteit aangeeft op basis van periodieke vaste betalingen en een vast rentepercentage.
public static double NPer(double Rate, double Pmt, double PV, double FV = 0, Microsoft.VisualBasic.DueDate Due = Microsoft.VisualBasic.DueDate.EndOfPeriod);
static member NPer : double * double * double * double * Microsoft.VisualBasic.DueDate -> double
Public Function NPer (Rate As Double, Pmt As Double, PV As Double, Optional FV As Double = 0, Optional Due As DueDate = Microsoft.VisualBasic.DueDate.EndOfPeriod) As Double
Parameters
- Rate
- Double
Verplicht. Het rentepercentage per periode. Als u bijvoorbeeld een autolening neemt met een jaarlijkse rente van 10 procent en per maand betaalt, bedraagt de rente per periode 0,1/12, oftewel 0,0083.
- Pmt
- Double
Verplicht. De betaling die elke periode moet worden verricht. Betalingen bevatten meestal hoofdsom en rente die niet veranderen gedurende de levensduur van de annuïteit.
- PV
- Double
Verplicht. De huidige waarde, of de huidige waarde, van een reeks toekomstige betalingen of ontvangsten. Wanneer u bijvoorbeeld geld leent om een auto te kopen, is het geleende bedrag de huidige waarde voor de verstrekker van de lening.
- FV
- Double
Optional. De toekomstige waarde of het gewenste saldo nadat u de laatste betaling hebt gedaan. De toekomstige waarde van een lening is bijvoorbeeld \$0 omdat dat de waarde is na de laatste betaling. Als u echter \$50.000 meer dan 18 jaar wilt besparen voor het onderwijs van uw kind, is \$50.000 de toekomstige waarde. Als dit argument wordt weggelaten, wordt 0 als standaardwaarde gebruikt.
- Due
- DueDate
Optional. Object van het type DueDate dat aangeeft wanneer betalingen verschuldigd zijn. Dit argument moet zijn DueDate.EndOfPeriod als betalingen aan het einde van de betalingsperiode moeten worden voldaan of DueDate.BegOfPeriod als betalingen aan het begin van de periode moeten worden voldaan. Als u dit weglaat, DueDate.EndOfPeriod wordt ervan uitgegaan.
Retouren
Het aantal termijnen voor een annuïteit op basis van periodieke vaste betalingen en een vast rentepercentage.
Uitzonderingen
Rate = 0 en Pmt = 0
Voorbeelden
In dit voorbeeld wordt de NPer functie gebruikt om het aantal perioden te retourneren waarin betalingen moeten worden gedaan om een lening af te betalen waarvan de waarde is opgenomen in PVal. Ook het rentepercentage per periode (APR / 12), de betaling (Payment), de toekomstige waarde van de lening (FVal) en een getal dat aangeeft of de betaling moet worden voldaan aan het begin of einde van de betalingsperiode (PayType).
Sub TestNPer()
Dim TotPmts As Double
Dim PVal, APR, Payment As Double
Dim PayType As DueDate
Dim Response As MsgBoxResult
' Usually 0 for a loan.
Dim Fval As Double = 0
PVal = CDbl(InputBox("How much do you want to borrow?"))
APR = CDbl(InputBox("What is the annual percentage rate of your loan?"))
' Usually 0 for a loan.
If APR > 1 Then APR = APR / 100
Payment = CDbl(InputBox("How much do you want to pay each month?"))
Response = MsgBox("Do you make payments at the end of month?", MsgBoxStyle.YesNo)
If Response = MsgBoxResult.No Then
PayType = DueDate.BegOfPeriod
Else
PayType = DueDate.EndOfPeriod
End If
TotPmts = NPer(APR / 12, -Payment, PVal, FVal, PayType)
If Int(TotPmts) <> TotPmts Then TotPmts = Int(TotPmts) + 1
MsgBox("It will take you " & TotPmts & " months to pay off your loan.")
End Sub
Opmerkingen
Een annuïteit is een reeks vaste contante betalingen gedurende een specifieke periode. Een annuïteit kan een lening zijn (bijvoorbeeld een hypotheek) of een investering (bijvoorbeeld een maandelijks spaarplan).
Voor alle argumenten worden betaalde bedragen (zoals stortingen op een spaarrekening) weergegeven als negatieve getallen, terwijl ontvangen bedragen (zoals dividenden) worden weergegeven als positieve getallen.