finance-solution

finance-solution 是一个用于时间价值金融问题的库。 💸

以下人员可能会发现这个库很有用

• 金融学生，他们想使用比简易手持计算器更好的工具来解决金融问题。使用这个库还可以减少人为错误，并提供比 Excel 更好的输出和数据展示。
• 新开发者，他们想通过金融主题学习 Rust。
• 经验丰富的 Rust 开发者，他们想了解更多关于金融的知识。
• 严肃的 Rust 开发者，他们想构建金融软件，并更喜欢依赖于经过严格测试的库，而不是重新发明轮子，花费数百小时开发和测试自己的库。

目前，这个库针对以下基本金融方程式

• 简单时间价值公式 -- 包括 present_value、future_value、rate 和 periods（在 Excel 中称为 NPER）。
• 现金流时间价值公式 -- 包括 present_value_annuity、future_value_annuity、net_present_value 和 payment（在 Excel 中称为 PMT）。
• 利率转换 -- 包括所有 apr、ear 和 epr 之间的转换，还包括连续复利转换（apr_continuous、ear_continuous）。

示例

一个商业伙伴将在3年后给你4000美元。你在市场上的回报率是5%。这笔交易对你现在来说价值多少？

使用 present_value() 返回 f64 类型的值

let future_value = 4_000;
let periods = 3;
let rate = 0.05;
let pv = present_value(rate, periods, future_value);
dbg!(pv);

// PRINTS TO TERMINAL:
// pv = 3455.350394125904 

该包还提供了用于四舍五入的辅助函数，例如 round_4，用于四舍五入到四位小数。有关更多详细信息，请参阅 round。

对于上述相同的问题，您可以使用 _solution 函数查看更好的输出并提供附加功能。

使用 present_value_solution() 返回一个自定义的 "solution" 结构体

let future_value = 4_000;
let periods = 3;
let rate = 0.05;
let answer = present_value_solution(rate, periods, future_value);
dbg!(answer);

// PRINTS TO TERMINAL:
// answer = TvmSolution {
//    calculated_field: PresentValue,
//    rate: 0.05,
//    periods: 3,
//    fractional_periods: 3.0,
//    present_value: 3455.350394125904,
//    future_value: 4000.0,
//    formula: "3455.3504 = 4000.0000 / (1.050000 ^ 3)",
//    formula_symbolic: "pv = fv / (1 + r)^n",
//}

如果您想探索计算过程中的每个周期发生了什么，您可以使用任何解决方案输出的 .series() 方法

使用 present_value_solution().series() 返回每个周期的 vec

let future_value = 4_000;
let periods = 3;
let rate = 0.05;
let answer = present_value_solution(rate, periods, future_value);
dbg!(answer.series());

// PRINTS TO TERMINAL:
// answer.series() = TvmSeries(
//     [
//         TvmPeriod {
//             period: 0,
//             rate: 0.0,
//             value: 3455.3503941259037,
//             formula: "3455.3504 = 3628.1179 / 1.050000",
//             formula_symbolic: "value = {next period value} / (1 + r)",
//         },
//         TvmPeriod {
//             period: 1,
//             rate: 0.05,
//             value: 3628.117913832199,
//             formula: "3628.1179 = 3809.5238 / 1.050000",
//             formula_symbolic: "value = {next period value} / (1 + r)",
//         },
//         TvmPeriod {
//             period: 2,
//             rate: 0.05,
//             value: 3809.523809523809,
//             formula: "3809.5238 = 4000.0000 / 1.050000",
//             formula_symbolic: "value = {next period value} / (1 + r)",
//         },
//         TvmPeriod {
//             period: 3,
//             rate: 0.05,
//             value: 4000.0,
//             formula: "4000.0000",
//             formula_symbolic: "value = fv",
//         },
//     ],
// )

要将每个周期以表格格式查看，请使用 .print_table() 方法。

使用 present_value_solution().series().print_table() 返回一个美观打印的表格

use num_format::{Locale};

let future_value = 4_000;
let periods = 3;
let rate = 0.05;
let answer = present_value_solution(rate, periods, future_value);
dbg!(answer.series().print_table());
// or use .print_table_locale() to specify your formatting preferences.
dbg!(answer.series().print_table_locale(&Locale::en, 4));

// PRINTS TO TERMINAL:
// period    rate       value
// ------  ------  ----------
//      0  0.0000  3,455.3504
//      1  0.0500  3,628.1179
//      2  0.0500  3,809.5238
//      3  0.0500  4,000.0000

在上面的表格中，您可以指定地区，如果您更喜欢不同的货币格式。例如，您的国家可能更喜欢 8.532,11 而不是 8,532.11。美观打印的表格可以轻松地复制粘贴到电子表格中。

let present_value = 13_000;
let periods = 5;
let rate = 0.08;
let answer = payment_solution(rate, periods, present_value, 0);
dbg!(answer.series().print_table());

// PRINTS TO TERMINAL:
// period  payments_to_date  payments_remaining    principal  principal_to_date  principal_remaining     interest  interest_to_date  interest_remaining
// ------  ----------------  ------------------  -----------  -----------------  -------------------  -----------  ----------------  ------------------
//      1       -3,255.9339        -13,023.7356  -2,215.9339        -2,215.9339         -10,784.0661  -1,040.0000       -1,040.0000         -2,239.6695
//      2       -6,511.8678         -9,767.8017  -2,393.2086        -4,609.1425          -8,390.8575    -862.7253       -1,902.7253         -1,376.9443
//      3       -9,767.8017         -6,511.8678  -2,584.6653        -7,193.8078          -5,806.1922    -671.2686       -2,573.9939           -705.6757
//      4      -13,023.7356         -3,255.9339  -2,791.4385        -9,985.2464          -3,014.7536    -464.4954       -3,038.4893           -241.1803
//      5      -16,279.6695              0.0000  -3,014.7536       -12,999.0000              -0.0000    -241.1803       -3,279.6695              0.0000