Module finance_solution::future_value_annuity

Future value annuity calculations. Given a series of cashflows, a number of periods such as years, and a fixed interest rate, what is the value of the series of cashflows (annuity) at the final payment?

For most common usages, we recommend the future_value_annuity_solution function, which provides a better debugging experience and additional features.

Example

let (rate, periods, annuity, due) = (0.034, 10, 500, false);
let fv_ann = finance_solution::future_value_annuity_solution(rate, periods, annuity, due);
dbg!(fv_ann);

Outputs to terminal:

{
calculated_field: FutureValueAnnuity,
rate: 0.034,
periods: 10,
present_value: -4179.341028819186,
future_value: -5838.660162934523,
due_at_beginning: false,
payment: 500.0,
sum_of_payments: 5000.0,
sum_of_interest: -5018.0011917537095,
formula: "-500 * ((1. - (1. / (1. + 0.034)).powf(10)) / 0.034);",
symbolic_formula: "-annuity * ((1. - (1. / (1. + rate)).powf(periods)) / rate);",
}

Functions

future_value_annuity	Returns the future value of annuity (a series of constant cashflows) at a constant rate. Returns f64.
future_value_annuity_solution	Returns the future value of annuity (a series of constant cashflows) at a constant rate. Returns custom solution struct with additional information and functionality.