numpy.fv_NumPy中文网

numpy.fv（rate，nper，pmt，pv，when ='end' ）[源代码] ¶

计算未来价值。

从版本1.18开始fv不推荐使用：有关详细信息，请参见NEP 32 [1]。使用numpy-financial库https://pypi.org/project/numpy-financial中的相应功能。

鉴于：

返回：

在结束时的值nper周期

参量

形状（M，）的标量或数组_ 率: 每个周期的利率为小数点（非百分比）
nper 标量或shape（M，）的array_like: 复利期数
pmt 标量或shape（M，）的array_like: 付款
pv 标量或形状为（M，）的array_like: 目前价值
当{{'begin'，1}，{'end'，0}}，{string，int}时，可选: 付款到期时（“开始”（1）或“结束”（0））。默认为{'end'，0}。

退货

出ndarray: 未来价值。如果所有输入均为标量，则返回标量浮点数。如果任何输入类似于array_like，则返回每个输入元素的将来值。如果多个输入类似于array_，则它们都必须具有相同的形状。

笔记

未来值通过求解方程式计算得出：

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

或者，当：rate == 0

fv + pv + pmt * nper == 0

参考文献

1个: NumPy增强提案（NEP）32， https：//numpy.org/neps/nep-0032-remove-financial-functions.html
2: 惠勒，DA，E.Rathke和R.Weir（编辑）（2009年5月）。Office应用程序的Open Document格式（OpenDocument）v1.2，第2部分：重新计算的公式（OpenFormula）格式-带注释的版本，预草稿12.结构化信息标准促进组织（OASIS）。美国马萨诸塞州比勒里卡。[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,692.93，可在10年内使用。

如果任何输入为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]) # may vary