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

定义

返回一个值,该值根据将来要支付的定期固定付款和固定利率指定年金的现值。

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

Optional. 进行最终付款后所需的未来价值或现金余额。 例如,贷款的未来值为 \$0,因为这是最终付款后的值。 但是,如果你想节省 \$50,000 超过 18 年的子女教育,那么 \$50,000 是未来的价值。 如果省略,则假定为 0。

Due
DueDate

Optional. 指定付款到期时间的类型 DueDate 的对象。 如果付款在付款期结束时到期,或者DueDate.EndOfPeriod付款在期初到期,则此参数必须是DueDate.BegOfPeriod此参数。 如果省略, DueDate.EndOfPeriod 则假定为

返回

年金的现值基于将来要支付的定期固定付款和固定利率。

示例

在此示例中,该 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 则还必须使用月份计算。

对于所有参数,现金支付 (如存款到储蓄) 用负数表示:收到的现金 ((如股息检查) )由正数表示。

适用于

另请参阅