Package selection guidance compiled from public package information, community data, and project usage.
A lightweight and straightforward Flutter package for converting units across various categories such as length, weight, temperature, and more. Designed to be simple to integrate and efficient in performance, it supports multiple platforms including Android, iOS, Web, macOS, Windows, and Linux. Ideal for apps requiring real-time unit conversions without heavy dependencies. The package provides a clean API with intuitive methods for common conversions, making it accessible for developers of all levels.
Use cases
App with measurement conversion
Travel or cooking apps
Educational tools
Scientific calculators
Cross-unit data display
Key features
Supports multiple unit types
Lightweight and fast
Cross-platform compatibility
Simple API
Extensible unit definitions
Suitable for
Developers needing basic unit conversion
Apps with international measurement needs
Projects prioritizing minimal dependencies
Considerations
Limited to predefined units
No custom unit creation
May require updates for new unit types
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
units_converter
units_converter is a package written in dart for dart & flutter developers. You should not take care of unit conversion when you want to internationalize your app, everything is already done with this package! You can also add your own custom conversion!
Note: most of the time is what you need, use this method if you just want to convert a unit in another unit. BUT, it is not recommended if you want to convert a unit to multiple units, or if you are interested in the symbol of a unit or if you are interested in the format of the string representation of the value (significant figures, scientific notation, etc.).
Convert a unit to another unit
Example 2: convert 1 meter in inches
// We give 1 meter as inputvar length = Length()..convert(LENGTH.meters, 1);
// We get the inchesvar unit = length.inches;
// We print the Unitprint('name:${unit.name}, value:${unit.value}, stringValue:${unit.stringValue}, symbol:${unit.symbol}');
Example 3: convert 1 degree in all the other angles units. This time we want also to specify that we just want 7 significant figures and we don't want trailing zeros (e.g. 1.000000 -> 1).
// Initialization of the objectvar angle = Angle(significantFigures: 7, removeTrailingZeros: false); // conversion
angle.convert(ANGLE.degree, 1);
// We get all the unitsvar units = angle.getAll(); //We get all ther others units// Let's print all of themfor (var unit in units) {
print('name:${unit.name}, value:${unit.value}, stringValue:${unit.stringValue}, symbol:${unit.symbol}');
}
As you can see in this example if you specify removeTrailingZeros: false, the stringValue keeps all the trailing zeros (the default is true). You can also ask for an certain number of significant figures in the stringValue.
Special type of conversion: numeral systems conversion
Warning! Numeral systems conversion is the only conversion that need the input as a String, and not as a double / int for obvious reasons
Example 4: convert '100' (decimal) to binary and hexadecimal
// We give '100' decimal as inputvar numeralSystems = NumeralSystems()..convert(NUMERAL_SYSTEMS.decimal, '100');
// We get the binary valueprint('Binary: ${numeralSystems.binary.stringValue}');
// We get the hexadecimal valueprint('Hexadecimal: ${numeralSystems.hexadecimal.stringValue}');
Output:
Binary: 1100100Hexadecimal: 64
Simple custom conversion
Use SimpleCustomProperty when you are dealing with a linear conversion between the units, i.e. when a unit is x times a value. In SimpleCustomProperty we have to define a conversionMap between a base unit, which must have a value of 1, and all the other units. In the example below we say that 1€ is 1.2271$, but also 0.9033₤, and so on and so forth.
Example 5: define the currency exchange rate with their symbols (optional) and perform the conversion between two of them.
finalMap<String, double> conversionMap = {
'EUR': 1,
'USD': 1.2271,
'GBP': 0.9033,
'JPY': 126.25,
'CNY': 7.9315,
};
// The map of the symbols is optional but nicefinalMap<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}');
Output:
1€ = 1.2271$
Custom conversion
In most cases, you will only need SimpleCustomProperty (see the previous section). SimpleCustomProperty allow you to define conversions in the form of y=ax. But if you need to define special relationship between units you need CustomProperty. This allow you to perform conversion like: y=ax+b and y=a/x+b (where y and x are the value of two units and a and b are two coefficient), for example the conversion between Celsius and Fahrenheit use the first relation and the conversion between km/l and l/100km has to be done with the second relation. Both can't be done with SimpleCustomProperty.
Example 6: let's define the following imaginary units of measurement:
KiloDash = 1000 * Dash
DashPlus1 = Dash + 1
OneOver(DashPlus1) = 1 / (DashPlus1)
As you can see all this relations can be structured like a conversion tree. Now you can take a look at the example below: it does in the code what we have just said.