numpy.fv¶

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

计算未来值。

给定：

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

返回：

在nper周期结束时的值

参数：	rate：标量或array_like的形状（M，）利率作为十进制（不是百分比）每期 nper：标量或array_like的形状（M，）复合周期数 pmt：标量或array_like形状（M，）付款 pv：形状（M，）的标量或数组类目前价值时：{{'begin'，1}，{'end'，0}}，{string，int} 付款到期时（“开始”（1）或“结束”（0））。默认为{'end'，0}。
返回：	out：ndarray 未来价值。如果所有输入是标量，则返回标量浮点。如果任何输入是array_like，则返回每个输入元素的未来值。如果多个输入是array_like，它们都必须具有相同的形状。

参数：

rate：标量或array_like的形状（M，）

利率作为十进制（不是百分比）每期

nper：标量或array_like的形状（M，）

复合周期数

pmt：标量或array_like形状（M，）

付款

pv：形状（M，）的标量或数组类

目前价值

时：{{'begin'，1}，{'end'，0}}，{string，int}

付款到期时（“开始”（1）或“结束”（0））。默认为{'end'，0}。

out：ndarray

未来价值。如果所有输入是标量，则返回标量浮点。如果任何输入是array_like，则返回每个输入元素的未来值。如果多个输入是array_like，它们都必须具有相同的形状。

笔记

未来值通过求解以下等式计算：

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

或费率 == 0：

fv + pv + pmt * nper == 0

参考文献

[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

例子

10年后现在节省100美元的未来价值是多少，每月节省100美元。假设利率是每月5％（每年）复利？

>>> np.fv(0.05/12, 10*12, -100, -100)
15692.928894335748

按照惯例，负号表示现金流出（即今天不可用的货币）。因此，按每年5％的利率每月节省100美元，就可以在10年内花费15,692.93美元。

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

>>> a = np.array((0.05, 0.06, 0.07))/12
>>> np.fv(a, 10*12, -100, -100)
array([ 15692.92889434,  16569.87435405,  17509.44688102])