Financial.PV(Double, Double, Double, Double, DueDate) 方法

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.dll

回傳一個基於定期固定支付及固定利率，指定年金現值的價值。

public static double PV(double Rate, double NPer, double Pmt, double FV = 0, Microsoft.VisualBasic.DueDate Due = Microsoft.VisualBasic.DueDate.EndOfPeriod);
static member PV : double * double * double * double * Microsoft.VisualBasic.DueDate -> double
Public Function PV (Rate As Double, NPer As Double, Pmt As Double, Optional FV As Double = 0, Optional Due As DueDate = Microsoft.VisualBasic.DueDate.EndOfPeriod) As Double

參數

Rate
Double

必須的。 每個週期的利率。 例如，如果您的汽車貸款的年利率 (APR) 是10%，並且每月付款，則每期的利率為 0.1/12 或 0.0083。

NPer
Double

必須的。 年金的總付款期間數。 例如，如果你是每月還款四年車貸，你的貸款有4個12期（或48期）的還款期。

Pmt
Double

必須的。 每個期間都要支付的款項。 付款通常包含在年金期間不會變動的本金和利息。

FV
Double

Optional. 你在支付最後一筆款項後想要的未來價值或現金餘額。 例如，貸款的未來價值為 \$0，因為這是最終還款後的價值。 然而，如果你想在18年內為孩子存下50,000美元，那麼50,000美元就是未來的價值。 如果沒有指定，會假設為 0。

Due
DueDate

Optional. 指定付款到期時間的物件 DueDate 。 這個論點必須是 DueDate.EndOfPeriod 付款是在付款期間結束時到期，或 DueDate.BegOfPeriod 是付款在該期間開始時到期。 若省略， DueDate.EndOfPeriod 則視為假定。

傳回

Double

年金的現值是基於未來定期固定支付及固定利率。

範例

在此範例中，函 PV 數回傳 \$1,000,000 年金的現值，未來 20 年每年可提供 \$50,000。 提供預期年利率 (APR) 、) (TotPmts 付款總數、每筆) (YrIncome 金額、投資 (FVal) 的未來總價值，以及指示每筆付款是在付款期開始或結束) (PayType 的數字。 請注意，這是一個 YrIncome 負數，因為它代表每年從年金中支付的現金。

Sub TestPV()
    ' Define money format.
    Dim Fmt As String = "###,##0.00"
    ' Annual percentage rate.
    Dim APR As Double = 0.0825
    ' Total number of payments.
    Dim TotPmts As Double = 20
    ' Yearly income.
    Dim YrIncome As Double = 50000
    ' Future value.
    Dim FVal As Double = 1000000
    ' Payment at beginning of month.
    Dim PayType As DueDate = DueDate.BegOfPeriod
    Dim PVal As Double = PV(APR, TotPmts, -YrIncome, FVal, PayType)
    MsgBox("The present value is " & Format(PVal, Fmt) & ".")
End Sub

備註

年金是指一段時間內，一系列的固定現金付款活動。 年金可能是一筆貸款 (例如房屋貸款) 或投資 (例如每月存款計劃)。

Rate和 NPer 參數必須以相同單位表示的付款期間計算。 例如，若 Rate 是用月份計算，則 NPer 也必須用月份計算。

對於所有引數，付出的現金 (例如要儲蓄的存款金額) 是由負數表示；收入的現金 (例如股利支票) 是由正數表示。

適用於

另請參閱