installment-js v1.1.1

Installment JS

a fast module to calculate loan/installment in js (browser/node.js) for Outstanding debt gradually decreases or Principal and interest divided equally installments, the sum of interest, detail of payment period, etc

Getting Started

Install with:

npm install installment-js

Calculating Installment:

  const { calculateInstallment } = require("installment-js");

  const result = calculateInstallment(
    500000000, //amount
    60, // total of months Installment
    7, // annual interest rate
    [installmentType?], //(optional) installment type InstallmentType.ODGE for Outstanding debt gradually decreases and InstallmentType.PIDE for Principal and interest divided equally
    [rounding?] // (optional) rounding for amount, you can pass the number or use the constant Rounding.ZERO, Rounding.ONE, Rounding.TWO,...
  );

/*
  returns
  {
    loanAmount: 500000000,
    totalLoanAndInterest: 588953250,
    totalInterest: 88953250,
    details: [
      {
        loanBeginingPeriod: 500000000,
        originLoanPaid: 6899388,
        interest: 2916500,
        totalPaid: 9815888,
        loanEndingPeriod: 493100612,
        month: 1
      },
      {
        loanBeginingPeriod: 493100612,
        originLoanPaid: 6947996,
        interest: 2867892,
        totalPaid: 9815888,
        loanEndingPeriod: 486152616,
        month: 2
      },
      ...
    ]
  }
*/

Documentation

Installment

calculateInstallment(amount, months, rate, installmentType?, rounding?)

Arguments

InstallmentType Constant

• Outstanding debt gradually decreases(ODGD)

• Principal and interest divided equally (PIDE)

Rounding Constant

Returns

{
  loanAmount: 500000000,
  totalLoanAndInterest: 588953250,
  totalInterest: 88953250,
  details: [
    {
      loanBeginingPeriod: 500000000,
      originLoanPaid: 6899388,
      interest: 2916500,
      totalPaid: 9815888,
      loanEndingPeriod: 493100612,
      month: 1
    },
    {
      loanBeginingPeriod: 493100612,
      originLoanPaid: 6947996,
      interest: 2867892,
      totalPaid: 9815888,
      loanEndingPeriod: 486152616,
      month: 2
    },
    {
      loanBeginingPeriod: 486152616,
      originLoanPaid: 6996605,
      interest: 2819283,
      totalPaid: 9815888,
      loanEndingPeriod: 479156011,
      month: 3
    },
    ...
  ]
}

Examples

import {
  calculateInstallment,
  InstallmentType,
  Rounding,
} from "installment-js";

const result = calculateInstallment(500, 12, 7.5);

const result1 = calculateInstallment(500, 12, 7.5, InstallmentType.PIDE);

const result1 = calculateInstallment(
  500,
  12,
  7.5,
  InstallmentType.PIDE,
  Rounding.TWO
);

Contributing

Im open for contributors :).

Release History

2024-03-04 v1.1.0

• Updated the formula for Principal and interest divided equally. The formula for calculating the monthly payment for a loan in the annuity method is as follows:

  PMT = (P * r * (1 + r)^n) / ((1 + r)^n - 1)

  Where:

  • PMT is the monthly payment.
  • P is the initial loan amount (principal).
  • r is the monthly interest rate (usually expressed as a decimal and calculated by dividing the annual interest rate by 12).
  • n is the total number of payment periods (months).