numpy.pv

原文：https://docs.scipy.org/doc/numpy/reference/generated/numpy.pv.html

译者：飞龙 UsyiyiCN

校对：（虚位以待）

numpy.pv(rate, nper, pmt, fv=0.0, when='end')[source]

计算当前值。

给定：

• 未来值fv
• 每个期间复利一次利息rate，其中有
• nper总计
• （固定）付款，pmt，付款
• 每个周期开始时（时 = {'begin'，1}）或结束（时 = {'end'，0}

返回：

现在的值

参数：	rate：array_like 利率（每期） NPER T0>：array_like 复合周期数 pmt：array_like 付款 fv：array_like，可选 未来价值 时：{{'begin'，1}，{'end'，0}}，{string，int} 付款到期时（“开始”（1）或“结束”（0））
返回：	out：ndarray，float 一系列付款或投资的现值。

笔记

通过求解以下等式计算当前值：

fv +
pv*(1 + rate)**nper +
pmt*(1 + rate*when)/rate*((1 + rate)**nper - 1) = 0

或费率 = 0：

fv + pv + pmt * nper = 0

pv，然后返回。

参考文献

[WRW]

Wheeler，D.A.，E.Rathke和R.Weir（Eds。）（2009年5月）。Office应用程序的打开文档格式（OpenDocument）v1.2，第2部分：重新计算公式（OpenFormula）格式 - 注释版本，预稿12。促进结构性信息标准组织（OASIS）。Billerica，MA，USA。[ODT文件]。可用：http://www.oasis-open.org/committees/documents.php?wg_abbrev=office-formula OpenDocument-formula-20090508.odt

例子

一个投资的现值（例如，初始投资）需要在每个月节省100美元的10年后总共需要15692.93美元？假设利率为每月5％（每年）复利。

>>> np.pv(0.05/12, 10*12, -100, 15692.93)
-100.00067131625819

按照惯例，负号表示现金流出（即，今天不可用的钱）。因此，在10年内最终可以节省15,692.93美元，每月节省100美元，年利率为5％，初始存款也应该是100美元。

如果任何输入是array_like，则pv返回相等形状的数组。让我们比较上面例子中的不同利率：

>>> a = np.array((0.05, 0.04, 0.03))/12
>>> np.pv(a, 10*12, -100, 15692.93)
array([ -100.00067132,  -649.26771385, -1273.78633713])

因此，在每月100美元“储蓄计划”相同的$ 15692.93下，年利率为4％和3％，需要初始投资分别为649.27美元和1273.79美元。