Flutter金融计算器插件库curo的使用

Flutter金融计算器插件库curo的使用

Curo简介

Curo是一个用于执行简单到高级分期信用金融计算的功能丰富的库。它能够解决固定期限分期信贷产品中的未知现金流值和隐含利率，例如租赁、贷款和分期付款合同。该库移植自curo-calculator TypeScript仓库，并进行了少量重构和代码重组。

更新日志

• 2024年12月：已开发了一个使用此库的Flutter应用程序，现在作为Web应用程序可用。目标是在解决所有问题后将其作为Android应用发布。为此，需要20名测试人员在Google Play上进行beta测试。如果您有兴趣帮忙，请联系我！[curocalculator@gmail.com]

概述

这个金融计算器库旨在解决未知现金流值和隐含利率，适用于租赁、贷款和分期付款合同等固定期限分期信贷产品。它设计用于超出标准金融代数的应用需求。

更多功能介绍请参阅GitHub仓库中的示例和配套的现金流图，这些图以图形方式表示每个示例的现金流入和流出。

使用示例

示例1：使用solveValue(...)查找未知现金流值

import 'package:curo/curo.dart';

Future<void> main() async {
  // Step 1: Instantiate the calculator
  final calculator = Calculator();

  // Step 2: Define the advance, payment, and/or charge cash flow series
  calculator.add(
    SeriesAdvance(
      label: 'Loan',
      value: 10000.0,
    ),
  );
  calculator.add(
    SeriesPayment(
      numberOf: 6,
      label: 'Instalment',
      value: null, // leave undefined or null when it is the unknown to solve
      mode: Mode.arrear,
    ),
  );

  // Step 3: Calculate the unknown cash flow value (result = 1707.00 to 2 decimal places)
  final valueResult = await calculator.solveValue(
    dayCount: const US30360(),
    interestRate: 0.0825,
  );

  print('The unknown instalment value is: ${valueResult.toStringAsFixed(2)}');
}

示例2：使用solveRate(...)查找隐含利率

import 'package:curo/curo.dart';

Future<void> main() async {
  // Step 1: Instantiate the calculator
  final calculator = Calculator();

  // Step 2: Define the advance, payment, and/or charge cash flow series
  calculator.add(
    SeriesAdvance(
      label: 'Loan',
      value: 10000.0,
    ),
  );
  calculator.add(
    SeriesPayment(
      numberOf: 6,
      label: 'Instalment',
      value: 1707.00,
      mode: Mode.arrear,
    ),
  );

  // Step 3: Calculate the IRR or Internal Rate of Return (result = 8.250040%)
  final irrRate = await calculator.solveRate(
    dayCount: const US30360(),
  );

  print('The IRR rate is: ${irrRate * 100}%');

  // Step 4: Calculate the APR for regulated EU Consumer Credit agreements (result = 8.569257%)
  final aprRate = await calculator.solveRate(
    dayCount: const EU200848EC(),
  );

  print('The APR rate is: ${aprRate * 100}%');
}

日计数惯例（Day Count Conventions）

日计数惯例是每个金融计算的关键组成部分，它决定了用于测量系列中每次现金流之间时间间隔的方法。支持的主要日计数惯例包括：

除了EU 2008/48/EC之外，所有惯例默认情况下都会根据相邻现金流的日期计算时间间隔。要覆盖此设置，使时间间隔参考首次提款日期（如XIRR计算），只需在相应的日计数惯例构造函数中传递useXirrMethod: true。

安装

使用Dart安装

$ dart pub add curo

使用Flutter安装

$ flutter pub add curo

许可证

版权所有 © 2022 Andrew Murphy。根据MIT许可证发布。

脚注

1. 尽管库使用资产融资术语，但它同样可以解决投资类场景中的问题。
2. 现金流图是金融交易时间和方向的图形表示。图中以水平线表示合同期限，垂直箭头表示资金流动方向。