repository·master·Indexed 22 days ago
https://github.com/ebradyjobory/finance.jsA pure JavaScript library (version 4.1.0) for common financial calculations without external dependencies. It provides a Finance class with methods to calculate Amortization (AM), Compound Annual Growth Rate (CAGR), Compound Interest (CI), Discount Factor (DF), Future Value (FV), Internal Rate of Return (IRR and XIRR), Leverage Ratio (LR), Net Present Value (NPV), Payback Period (PP), Present Value (PV), Profitability Index (PI), Return on Investment (ROI), Rule of 72 (R72), Weighted Average Cost of Capital (WACC), Loan Payment (PMT), Inflation-adjusted Return (IAR), CAPM, and Stock Present Value.
To use the library, require or import the Finance class and instantiate it with new Finance().
var Finance = require('financejs');
var finance = new Finance();For TypeScript users:
import { Finance } from 'financejs';
let finance = new Finance();You can install Finance.js via npm to use it in your Node.js or frontend projects.
Alternatively, you can download or fork the repository from GitHub, extract the finance.js file, and include it directly in your client-side application.
npm install financejs --saveFinance class. The class is available via module.exports or module.exports.Finance in CommonJS environments.Calculates the bottom line return of any investment.
Signature: finance.ROI(initial investment, earnings);
Measures the return taking into account the time period's inflation rate.
Signature: finance.IAR(investment Return, inflation Rate);
Calculates the value of an asset or cash at a specified date in the future that is equivalent in value to a specified sum today.
Signature: finance.FV(rate, cash flow, number of periods);
Calculates interest on the initial principal and also on the accumulated interest of previous periods.
Signature: finance.CI(rate, compoundings per period, principal, number of periods);
Calculates the financial leverage of a company or individual to measure the ability to meet financial obligations.
Signature: finance.LR(total liabilities, total debts, total income);
Determines the Internal Rate of Return when cash flows occur at irregular intervals.
Signature: finance.XIRR([cash flows], [dates], guess);
[cash flows]: Array of cash flow amounts.[dates]: Array of Date objects corresponding to the cash flows.guess: An initial guess for the IRR.Calculates the discount rate that makes the net present value of all cash flows from a particular project equal to zero.
Signature: finance.IRR(initial investment, [cash flows]);
Calculates the rate that a company is expected to pay on average to all its security holders to finance its assets.
Signature: finance.WACC(market value of equity, market value of debt, cost of equity, cost of debt, tax rate);