Financial.PV(Double, Double, Double, Double, DueDate) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回一个值,该值根据将来要支付的定期固定付款和固定利率指定年金的现值。
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 则还必须使用月份计算。
对于所有参数,现金支付 (如存款到储蓄) 用负数表示:收到的现金 ((如股息检查) )由正数表示。