UNPKG

node-finance

Version:

Financial functions for NodeJS

robhicks/node-finance

115 lines (102 loc) • 5.42 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
node-finance ========= node-finance is a Node module that provides basic finance methods. node-finance is implemented where it can be used synchronously or asynchronously. To use it asynchronously, pass in a callback at the end of a function. FUNCTIONS ========= PVofLumpSum ----------- Calculates the present value of a lump sum received in the future. Arguments include: * rate (required) - the interest rate per period * NPER (required) - total number of periods * FV (optional) - the future value or lump sum to be received PV -- Calculates the present value of an investment resulting from a series of regular payments. Arguments include: * rate (required) - the interest rate per period * NPER (required) - total number of payment periods * PMT (required) the regular payment made each period * type (optional) - wether payments made 0 - at the end of each period or 1 - at the start of each period (including a payment at the start of the term) PVofPerpetuity -------------- Calculates the present value of an investment with an unlimited number of regular payments. Arguments include: * rate (required) - the interest rate per period * NPER (required) - total number of payment periods * PMT (required) the regular payment made each period CUMIPMT ------- Calculate the total interest paid on a loan in specified periodic payments. Arguments include: * rate (required) - interest rate specified as a percentage, e.g., 10.5 * periods (required) - the total number of payment periods in the term * pv (required) - the initial sum borrowed * start (optional) - the first period to include. Periods are numbered beginning with 1 * end (optional) - the last period to include * type (optional) - when payments are made: - 0 - at the end of each period - 1 - at the start of each period (including a payment at the start of the term) * callback (optional) - callback for asynchronous processing using Node's CommonJS format FV -- Calculates future value of an investment based on equal periodic payments. Arugments include: * rate (required) - the periodic interest rate * NPER (required) - the number of periods * PMT (required) - the equal periodic payments * type (optional) - whether the payment is due at the beginning (1) or the end (0) of a period NPER ---- Caculates the number of periods for an investment based on periodic, constant payments and a constant interest rate. Arguments include: * rate (required) - the periodic interest rate * PMT (required) - the constant payment paid in each period * FV (required) - the future value of the last period * type (optional) - whether the payment is due at the beginning (1) or the end (0) of a period PMT --- Calculates the payment for a loan with the following parameters. * PV is loan amount * NPER is the number of periods * rate is the rate per period * type (optional) - whether the payment is due at the beginning (1) or the end (0) of a period GenAmortizationSchedule ----------------------- This function generates an amortization schedule. The schedule is returned as a Javascript object. The function accepts the following arguments: * amount (required): the starting principal amount of the loan * months (required): the number of whole months over which the loan extends * rate (required): the annual interest rate of the loan expressed as a percentage, e.g., 10.5 * firstPaymentDate (optional): the date the first payment will be made * frequency (optional): the payment frequency, which can be any of the following: semimonthly - twice a month monthly - once each month bimonthly - every two months quarterly - every quarter semiannually - ever 6 months annually - ever 12 months none or one - only one payment at the end of the loan - typically don't mix this with balloonDate * balloonDate (optional): the date a balloon payment will be made. This date will be forced to earliest corresponding payment date. This date will be ignored if it is greater than the term (months) of the loan. The return object contains an array, with each array element containing the following fields: * paymentNumber - the number for a payment * principle: the principal balance remaining at the end of the period * accumulatedInterest: the interest accumulate from all previous periods through this period * payment: the periodic payment the borrower is required to pay * paymentToPrinciple: the amount of the payment allocated to paying down the principal * paymentToInterest: the amount of the payment allocated to paying interest * date: the date of the payment for the period payments -------- Calculates the number of payments for a loan. This is different than NPER. NPER calculates the number of periods used in an annuity or loan from a financial perspective. This function looks at how frequently a customer chooses to make payments. This function has the following arguments: * NPER (required) - the number of periods used in calculating interest for a loan * frequency (optional): the payment frequency, which can be any of the following: - semimonthly - twice a month - monthly - once each month - bimonthly - every two months - quarterly - every quarter - semiannually - ever 6 months - annually - ever 12 months - none or one - only one payment at the end of the loan - typically don't mix this with balloonDate