Financial.PV 方法

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

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function PV ( _
    Rate As Double, _
    NPer As Double, _
    Pmt As Double, _
    <OptionalAttribute> Optional FV As Double = 0, _
    <OptionalAttribute> Optional Due As DueDate = DueDate.EndOfPeriod _
) As Double
'用途
Dim Rate As Double
Dim NPer As Double
Dim Pmt As Double
Dim FV As Double
Dim Due As DueDate
Dim returnValue As Double

returnValue = Financial.PV(Rate, NPer, Pmt, FV, Due)

public static double PV (
    double Rate,
    double NPer,
    double Pmt,
    [OptionalAttribute] double FV,
    [OptionalAttribute] DueDate Due
)

public:
static double PV (
    double Rate, 
    double NPer, 
    double Pmt, 
    [OptionalAttribute] double FV, 
    [OptionalAttribute] DueDate Due
)

public static double PV (
    double Rate, 
    double NPer, 
    double Pmt, 
    /** @attribute OptionalAttribute() */ double FV, 
    /** @attribute OptionalAttribute() */ DueDate Due
)

public static function PV (
    Rate : double, 
    NPer : double, 
    Pmt : double, 
    FV : double, 
    Due : DueDate
) : 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.EndOfPeriod (若付款期限是付款期間的結束日)，或 DueDate.BegOfPeriod (若付款期限是付款期間的開始日)。如果省略，則假設為 DueDate.EndOfPeriod。

傳回值

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

備註

如需詳細資訊，請參閱 Visual Basic 的主題 PV 函式。

年金是在約定期間內一連串的固定現金付款。年金可以是借貸 (例如房屋抵押貸款)，也可以是投資 (例如每月定存存單)。

Rate 和 NPer 引數必須使用以相同單位表示的付款週期計算。例如，如果 Rate 是以月計算，則 NPer 也必須以月來計算。

凡是引數，現金支出 (例如存款) 都以負數來表示，現金收入 (例如股息支票) 則以正數來表示。

範例

在這個範例中，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

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

.NET Compact Framework

支援版本：2.0、1.0

請參閱

參考

Financial 類別
Financial 成員
Microsoft.VisualBasic 命名空間

其他資源

PV 函式
財務摘要