Flutter单位转换插件units_converter的使用

units_converter 是一个为Dart和Flutter开发者编写的Dart包。当你想要国际化你的应用时，不需要再担心单位转换的问题，因为这个包已经为你处理好了！你还可以添加自己的自定义转换！

这个包被 Converter NOW 使用！

以下是 units_converter 包的详细用法。

目录

• 简单的单位转换
• 单位转换
• 将一个单位转换为所有其他单位
• 特殊的转换：进制系统转换
• 简单自定义转换
• 自定义转换

简单的单位转换

示例1：将1米转换为英寸

// 将1米转换为英寸
var inches = 1.convertFromTo(LENGTH.meters, LENGTH.inches);
// 打印结果
print(inches); // 输出: 39.37007874015748

对于进制系统转换，也可以类似操作：

// 将'8B'十六进制转换为八进制
var octal = '8B'.convertFromTo(NUMERAL_SYSTEMS.hexadecimal, NUMERAL_SYSTEMS.octal);
// 打印结果
print(octal); // 输出: 213

单位转换

示例2：将1米转换为英寸

// 初始化Length对象并输入1米
var length = Length()..convert(LENGTH.meters, 1);
// 获取英寸值
var unit = length.inches;
// 打印结果
print('name:${unit.name}, value:${unit.value}, stringValue:${unit.stringValue}, symbol:${unit.symbol}');
// 输出: name:LENGTH.inches, value:39.370078740157474, stringValue:39.37007874, symbol:in

将一个单位转换为所有其他单位

示例3：将1度转换为所有其他角度单位，并指定保留7位有效数字且不删除尾随零

// 初始化Angle对象，指定7位有效数字且不删除尾随零
var angle = Angle(significantFigures: 7, removeTrailingZeros: false);
angle.convert(ANGLE.degree, 1); // 转换1度
var units = angle.getAll(); // 获取所有单位
for (var unit in units) {
  print('name:${unit.name}, value:${unit.value}, stringValue:${unit.stringValue}, symbol:${unit.symbol}');
}

输出：

name:ANGLE.degree, value:1.0, stringValue:1.000000, symbol:°
name:ANGLE.minutes, value:60.0, stringValue:60.00000, symbol:'
name:ANGLE.seconds, value:3600.0, stringValue:3600.000, symbol:''

特殊的转换：进制系统转换

示例4：将’100’（十进制）转换为二进制和十六进制

// 初始化NumeralSystems对象
var numeralSystems = NumeralSystems();
numeralSystems.convert(NUMERAL_SYSTEMS.decimal, '100'); // 输入'100'十进制
print('Binary: ${numeralSystems.binary.stringValue}'); // 获取二进制值
print('Hexadecimal: ${numeralSystems.hexadecimal.stringValue}'); // 获取十六进制值

输出：

Binary: 1100100
Hexadecimal: 64

简单自定义转换

示例5：定义货币汇率并进行转换

final Map<String, double> conversionMap = {
  'EUR': 1,
  'USD': 1.2271,
  'GBP': 0.9033,
  'JPY': 126.25,
  'CNY': 7.9315,
};

final Map<String, String> mapSymbols = {
  'EUR': '€',
  'USD': '\$',
  'GBP': '₤',
  'JPY': '¥',
  'CNY': '¥',
};

var customConversion = SimpleCustomProperty(conversionMap, mapSymbols: mapSymbols);
customConversion.convert('EUR', 1);
Unit usd = customConversion.getUnit('USD');
print('1€ = ${usd.stringValue}${usd.symbol}');

输出：

1€ = 1.2271$

自定义转换

示例6：定义复杂的单位转换关系

ConversionNode conversionTree = ConversionNode(
  name: 'Dash',
  children: [
    ConversionNode(
      name: 'KiloDash',
      coefficientProduct: 1000,
    ),
    ConversionNode(
      name: 'DashPlus1',
      coefficientSum: -1,
      children: [
        ConversionNode(
          name: 'OneOver(DashPlus1)',
          conversionType: ConversionType.reciprocalConversion,
        ),
      ],
    ),
  ],
);

final Map<String, String> symbolsMap = {
  'Dash': 'dsh',
  'KiloDash': 'kdsh',
};

var dash = CustomProperty(
  conversionTree: conversionTree,
  mapSymbols: symbolsMap,
  name: 'Conversion of Dash',
);

dash.convert('Dash', 1);
var myUnits = dash.getAll();
for (var unit in myUnits) {
  print('name:${unit.name}, value:${unit.value}, stringValue:${unit.stringValue}, symbol:${unit.symbol}');
}

输出：

name:Dash, value:1.0, stringValue:1, symbol:dsh
name:KiloDash, value:0.001, stringValue:0.001, symbol:kdsh
name:DashPlus1, value:2.0, stringValue:2, symbol:null
name:OneOver(DashPlus1), value:0.5, stringValue:0.5, symbol:null

支持的单位类型

units_converter 支持多种单位类型的转换，包括但不限于：

• 物质的量（摩尔、毫摩尔等）
• 角度（度、弧度等）
• 面积（公顷、英亩等）
• 数字数据（字节、千兆比特等）
• 密度（克每升、微克每毫升等）
• 能量（焦耳、千瓦时等）
• 力（牛顿、千克力等）
• 燃油消耗（英里每小时、公里每小时等）
• 长度（米、英里等）
• 摩尔质量（克每摩尔、毫克每毫摩尔等）
• 质量（千克、盎司等）
• 进制系统（十六进制、二进制等）
• 功率（千瓦、马力等）
• 压力（巴、磅每平方英寸等）
• 鞋码（欧码、美码等）
• SI前缀（吉、太等）
• 速度（英里每小时、公里每小时等）
• 温度（摄氏度、华氏度等）
• 时间（秒、年等）
• 扭矩（牛顿米、达因米等）
• 体积（升、立方米等）

通过这些示例代码和详细的说明，你可以轻松地在Flutter项目中使用 units_converter 包来实现各种单位之间的转换。