Flutter金融计算插件xirr_flutter的使用

Flutter金融计算插件xirr_flutter的使用

特性

本库用于计算金融投资的内部收益率（XIRR）。它使用了牛顿-拉夫森方法来计算内部收益率。

开始使用

库在输入不符合预期时会抛出异常：

  • 如果所有交易均为正数或负数
  • 如果所有交易都在同一天进行
  • 如果未传递任何交易

请参阅测试用例以了解更多信息。

使用方法

存款/投资应以负数形式提供，取款则应以正数形式提供。

List<Transaction> transactions = [];

transactions.add(Transaction.withStringDate(-1000, "2010-01-01")); // 存款
transactions.add(Transaction.withStringDate(1100, "2011-01-01"));   // 取款

final double? result = XirrFlutter.withTransactions(transactions).calculate();
expect(result, 0.10);

额外信息

该库基于RayDeCampo的Java Xirr库创建，可在以下地址找到： https://github.com/RayDeCampo/java-xirr

因此，库的条款和许可遵循原始创作者的规定。

完整示例Demo

以下是一个完整的示例，展示如何使用xirr_flutter插件来计算内部收益率：

import 'package:flutter/material.dart';
import 'package:xirr_flutter/xirr_flutter.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('XIRR Flutter Demo'),
        ),
        body: Center(
          child: CalculateButton(),
        ),
      ),
    );
  }
}

class CalculateButton extends StatefulWidget {
  [@override](/user/override)
  _CalculateButtonState createState() => _CalculateButtonState();
}

class _CalculateButtonState extends State<CalculateButton> {
  String resultText = '';

  void calculateXIRR() {
    List<Transaction> transactions = [];

    transactions.add(Transaction.withStringDate(-1000, "2010-01-01")); // 存款
    transactions.add(Transaction.withStringDate(1100, "2011-01-01"));   // 取款

    final double? result = XirrFlutter.withTransactions(transactions).calculate();

    setState(() {
      resultText = result != null ? 'XIRR: ${result.toStringAsFixed(2)}' : '计算失败';
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: calculateXIRR,
      child: Text('计算XIRR'),
    );
  }
}

更多关于Flutter金融计算插件xirr_flutter的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter金融计算插件xirr_flutter的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，以下是如何在Flutter项目中使用xirr_flutter插件来进行金融计算的示例代码。xirr_flutter插件主要用于计算非定期现金流的内部收益率（XIRR）。

首先，确保你的Flutter项目已经配置好，并且你已经在pubspec.yaml文件中添加了xirr_flutter依赖：

dependencies:
  flutter:
    sdk: flutter
  xirr_flutter: ^最新版本号  # 请替换为实际最新版本号

然后运行flutter pub get来安装依赖。

接下来，你可以在你的Dart文件中使用xirr_flutter插件。以下是一个简单的示例，展示如何计算XIRR：

import 'package:flutter/material.dart';
import 'package:xirr_flutter/xirr_flutter.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String result = '';

  void _calculateXIRR() async {
    // 示例现金流数据，包含日期和金额
    var cashFlows = [
      CashFlow(date: DateTime(2022, 1, 1), amount: -10000), // 初始投资，负数表示支出
      CashFlow(date: DateTime(2023, 1, 1), amount: 3000),   // 第一次收益
      CashFlow(date: DateTime(2024, 1, 1), amount: 4000),   // 第二次收益
      CashFlow(date: DateTime(2025, 1, 1), amount: 5000),   // 第三次收益
    ];

    try {
      double xirr = await calculateXIRR(cashFlows);
      setState(() {
        result = 'XIRR: $xirr';
      });
    } catch (e) {
      setState(() {
        result = 'Error: ${e.toString()}';
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('XIRR Calculation'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              Text(result),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: _calculateXIRR,
                child: Text('Calculate XIRR'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

// CashFlow类定义，用于存储日期和金额
class CashFlow {
  DateTime date;
  double amount;

  CashFlow({required this.date, required this.amount});
}

在这个示例中，我们定义了一个简单的Flutter应用，其中包含一个按钮和一个显示XIRR结果的文本。当用户点击按钮时，应用会调用_calculateXIRR函数来计算给定现金流的XIRR。

请注意，xirr_flutter插件内部可能会使用异步操作来计算XIRR，因此我们使用了await关键字，并且函数是async的。

运行这个应用，点击“Calculate XIRR”按钮，你应该能够看到计算出的XIRR结果。如果现金流数据或日期格式有误，插件可能会抛出一个异常，我们在代码中捕获并显示了错误信息。

确保你已经正确安装并导入了xirr_flutter插件，并且根据你的实际需求调整现金流数据。

回到顶部