numpy.fv

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

Вычислить будущую стоимость.

Устарело начиная с версии 1.18: fv устарело; подробности см. в NEP 32 [1]. Используйте соответствующую функцию в библиотеке numpy-financial, https://pypi.org/project/numpy-financial.

Дано:

• настоящая стоимость, pv
• ставка процента rate с капитализацией один раз за период, из которых
• nper всего
• фиксированный платёж, pmt, выплачиваемый
• в начале (when = {‘begin’, 1}) или в конце (when = {‘end’, 0}) каждого периода

Возвращает:

значение в конце nper периодов

Параметры

ratescalar or array_like of shape(M, )

Ставка процента в десятичном формате (а не в процентах) за период

nperscalar or array_like of shape(M, )

Количество периодов капитализации

pmtscalar or array_like of shape(M, )

Платёж

pvscalar or array_like of shape(M, )

Настоящая стоимость

when{{‘begin’, 1}, {‘end’, 0}}, {string, int}, optional

Когда платёжи осуществляются (‘begin’ (1) или ‘end’ (0)). По умолчанию {‘end’, 0}.

Возвращает

outndarray

Будущая стоимость. Если все входные данные являются скалярами, возвращает скалярное значение с плавающей точкой. Если любой входной параметр является массивом, возвращает будущие значения для каждого элемента входных данных. Если несколько входных параметров являются массивами, они все должны иметь одинаковую форму.

Примечания

Будущая стоимость вычисляется путём решения уравнения:

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

Wheeler, D. A., E. Rathke, and R. Weir (Eds.) (2009, May). Open Document Format for Office Applications (OpenDocument)v1.2, Part 2: Recalculated Formula (OpenFormula) Format - Annotated Version, Pre-Draft 12. Organization for the Advancement of Structured Information Standards (OASIS). Billerica, MA, USA. [ODT Document]. Available: 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

По соглашению, отрицательный знак обозначает отток денежных средств (т.е. деньги, которые недоступны сегодня). Таким образом, сбережение 100 долларов в месяц при ставке 5% годовых приводит к 15 692,93 долларам, которые можно потратить через 10 лет.

Если любой входной параметр является массивом, возвращается массив с той же формой. Давайте сравним различные процентные ставки из приведенного выше примера.

>>> 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