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

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

來源:

Financial.vb

傳回值，指定根據未來要支付的定期、定額付款及固定利率所計算的年金現值。

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 x 12 (即 48) 期。

Pmt

Double

必要。 每一期所要付的款項。 款項通常包含本金，以及不會隨著年金的有效期間而變更的利息。

FV

Double

選擇性。 您在最後一次付款之後想要的未來價值或現金餘額。 例如，貸款的未來值為 $0，因為是代表最後一期付款之後的值。 然而，如果您想在 18 年內存下美金 $50,000 元做為子女教育費用，那麼美金 $50,000 元就是未來值。 如果省略，則假設為 0。

Due

DueDate

選擇性。 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 也必須使用月份來計算。

對於所有自變數，支付的現金 (例如儲存) 的現金會以負數表示;收到現金 (，例如正數表示) 的除數檢查。

另請參閱

• 財務摘要