README

支持指定提前还款支付的贷款偿还计划计算。支持等额本息和等额本金两种还款方式。

重要! 包中的所有货币值都是整数，代表元和分之和。例如，100.5元（100元50分）在服务中表示为整数100500。

安装

通过 composer: composer require serganbus/credit-calculator

使用

计算器的使用示例

require __DIR__ . '/../vendor/autoload.php';

use Credits\Calculator;
use Credits\CreditParams;
use Credits\UnexpectedPayment;
use Credits\RepaymentSchedule;

$params = new CreditParams(new DateTime('2019-10-31 00:00:00'), 100000000, 990, 12, CreditParams::DURATION_MONTH);
$unexpectedPayments = [
    new UnexpectedPayment(10000000, new DateTime('2019-12-15 00:00:00'), UnexpectedPayment::LESS_PAYMENT),
    new UnexpectedPayment(3565411, new DateTime('2020-01-13 00:00:00'), UnexpectedPayment::LESS_LOAN_PERIOD),
    new UnexpectedPayment(15000000, new DateTime('2020-02-29 00:00:00'), UnexpectedPayment::LESS_LOAN_PERIOD),
];

$calculator = new Calculator;

// считаем график погашений с аннуитетными платежами
// Чтобы были дифференцированные платежи, третьим параметром указываем Calculator::TYPE_TYPE_DIFFERENTIAL

/** @var RepaymentSchedule $schedule График платежей */
$schedule = $calculator->calculate($params, $unexpectedPayments, Calculator::TYPE_ANNUITY);
foreach ($schedule as $repayment) {
    /** @var DateTime $date Дата очередного платежного периода */
    $date = $repayment->getDate()->format('d.m.Y');

    /** @var int $payment Сумма очередного платежа */
    $payment = $repayment->getPayment();

    /** @var int $percents Проценты по очередному платежу */
    $percents = $repayment->getPercents();

    /** @var int $body Тело займа по очередному платежу */
    $body = $repayment->getBody();

    /** @var int $body Остаток по займу после платежа */
    $balance = $repayment->getBalance();
}

/** @var int $total Получить сумму всех платежей по займу */
$total = $schedule->calculateTotalPayments();

/** @var int $overpayment Получить сумму переплаты по займу */
$overpayment = $schedule->calculateOverpayment();

/** @var int $requestedSum Получить сумму займа */
$requestedSum = $schedule->getCreditParams()->getRequestedSum();

/** @var string psk Полная стоимость кредита в процентах годовых с округлением до 3х знаков */
$psk = $schedule->calculateTotalCost();

扩展

可以编写自己的算法来计算给定信用参数的还款计划。为此，需要实现接口 Credits\Types\Calculatable。

计算器类的初始化通过配置进行参数化，其中键是还款方式（等额本息或等额本金），值是实现接口 Credits\Types\Calculatable 的计算还款计划算法。