numpy.pmt

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

Вычислить платёж по кредиту, включающий основной долг и проценты.

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

Дано:

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

Возвращает:

периодический (фиксированный) платёж.

Параметры

ratearray_like

Процентная ставка (за период)

nperarray_like

Количество периодов начисления

pvarray_like

Текущая стоимость

fvarray_like, optional

Будущая стоимость (по умолчанию = 0)

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

Когда платёж производится (‘begin’ (1) или ‘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

для pmt.

Обратите внимание, что вычисление ежемесячного платежа по ипотеке — лишь одно из применений этой функции. Например, pmt возвращает периодический платёж, который необходимо внести, чтобы достичь указанного будущего баланса, учитывая начальный платёж, фиксированную, периодически начисляемую процентную ставку и общее количество периодов.

Ссылки

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-formulaOpenDocument-formula-20090508.odt

Примеры

Какой ежемесячный платёж необходим для погашения кредита на сумму 200 000 долларов в течение 15 лет при годовой процентной ставке 7,5%?

>>> np.pmt(0.075/12, 12*15, 200000)
-1854.0247200054619

Для погашения (т. е. получения будущей стоимости 0) 200 000 долларов, полученных сегодня, потребовался бы ежемесячный платёж в размере 1854,02 долларов. Обратите внимание, что этот пример иллюстрирует использование fv со значением по умолчанию 0.