A library to help Dart developers to convert unities and a few other things.

English | Português

Usage

A simple usage example:

import 'package:unities_helper/unities_helper.dart';

main() {
  /// Convert 25°C into Fahrenheit
  final temperature = convert<Temperature>(
    Temperature.celcius, // from
    Temperature.fahrenheit, // to
    25, // value
  );
  print(temperature);
}

A more detailed example can be found on the example folder

Supported conversions

Area
Square Kilometre (km²) Square metre (m²) Square mile (mi²)
Square yard Square foot Square inch (in²)
Hectare Acre 
main() {
  final area = convertArea(
    Area.squareMetre, // from
    Area.squareKilometre, // to
    10000000, // value
  );
  print(area); // 10
}

Color spaces
HEX HSV HSLA RGB 
main() {
  final hex = RGBColor(red: 255, green: 255, blue: 255).toHex;
  print(hex);
}

Data Transfer Rate

bit kilo mega giga tera
kibibit mebibit gibibit tebibit
bit kilobit megabit gigabit terabit
kilobyte megabyte gigabyte terabyte 
main() {
  final rate = convertDataTransferRate(
    DataTransferRate.gigabyte, // from
    DataTransferRate.megabyte, // to
    1, // value
  );
  print(rate); // 1000
}

Digital storage

bit kilo mega giga tera peta
bit kilobit megabit gigabit terabit petabit
byte kibibit mebibit gibibit tebibit pebibit
kilobyte megabyte gigabyte terabyte petabyte
kibibyte mebibyte gibibyte tebibyte pebibyte 
main() {
  final storage = convertDigitalStorage(
    DigitalStorage.gigabyte, // from
    DigitalStorage.megabyte, // to
    1, // value
  );
  print(storage); // 1000
}

Energy
Joule Kilojoule Gram calorie
Kilocalorie Watt-hour Kilowatt-hour
electron-volt Termal Unit Foot-pound 
main() {
  final energy = convertEnergy(
    Energy.kilocalorie, // from
    Energy.gramCalorie, // to
    1, // value
  );
  print(energy); // 1000
}

Frequency
Hertz (Hz) Kilohertz (kHz) Megahertz (mHz) Gigahertz (gHz) 
main() {
  final frequency = convertEnergy(
    Frequency.megahertz, // from
    Frequency.hertz, // to
    1, // value
  );
  print(frequency); // 1000000
}

Fuel Economy
Kilometer per litre Liter per 100 kilometres
Mile per US Gallon Mile per Imperial Gallon 
main() {
  final fuel = convertFuelEconomy(
    FuelEconomy.kilometerPerLitre, // from
    FuelEconomy.milePerUsGallon, // to
    1, // value
  );
  print(fuel); // 2,35215
}

Length
Nanometer Micrometer Millimeter Centimeter
Meter Kilometer Inch Mile
Yard Feet Nautical Mile 
main() {
  final length = convertLength(
    Length.centimeter, // from
    Length.meter, // to
    100, // value
  );
  print(length); // 1
}

Mass
Tonne Gram Kilogram Milligram
Microgram Stone Pound Ounce 
main() {
  final mass = convertMass(
    Mass.kilogram, // from
    Mass.gram, // to
    1, // value
  );
  print(mass); // 1000
}

Plane Angle°
Degree Gradian Milliradian
Radian Minute of arc Second of arc 
main() {
  final angle = convertPlaneAngle(
    PlaneAngle.degree, // from
    PlaneAngle.minuteOfArc, // to
    1, // value
  );
  print(angle); // 60
}

Pressure
Bar Pascal Torr Standart Atmosphere
Pounc-force \in²

\in² = per square-inch

main() {
  final pressure = convertPressure(
    Pressure.bar, // from
    Pressure.pascal, // to
    1, // value
  );
  print(pressure); // 100000
}

Speed
Miles/h Foot/s Metre/s Kilemetre/h Knot 
main() {
  final speed = convertSpeed(
    Speed.metrePerSecond, // from
    Speed.kilometrePerHour, // to
    1, // value
  );
  print(speed); // 3.6
}

Temperature
Celcius Fahrenheit Kelvin 
main() {
  final temperature = convertTemperature(
    Temperature.celcius, // from
    Temperature.fahrenheit, // to
    0, // value
  );
  print(temperature); // 32
}

Time
Nanosecond microsend millisecond second minute
hour day week month year
decade centure millenium 
main() {
  final time = convertTime(
    Time.minute, // from
    Time.second, // to
    1, // value
  );
  print(temperature); // 60
}

Volume
Liquid Gallon Liquid Quart Liquid Pint
Cup Fluid Ounce Tablespoon
Teaspoon Cubic Metre Litre
Millilitre Gallon Cubic Foot
Cubic Inch 
main() {
  final volume = convertVolume(
    Volume.litre, // from
    Volume.millilitre, // to
    1, // value
  );
  print(volume); // 1000
}

Using extension methods

Instead of using convert + unit name, you can use num.as + unit name. For example, if I want to convert mass, I can do it with two ways:

Using convert method

main() {
  final mass = convertMass(Mass.kilogram, Mass.gram, 10);
  print(mass);
}

Using extension methods

main() {
  final mass = 10.asMass(Mass.kilogram).toGram;
  print(mass);
}

Both will print the same results. You can use extension methods with the following conversion types:

  • ✔️ Area
  • ❌ Color
  • ✔️ Data Transfer Rate
  • ✔️ Digital Storage
  • ✔️ Energy
  • ✔️ Frequency
  • ✔️ Fuel Economy
  • ✔️ Length
  • ✔️ Mass
  • ✔️ Plane Angle
  • ✔️ Pressure
  • ✔️ Speed
  • ✔️ Temperature
  • ✔️ Time
  • ✔️ Volume

Features and bugs

Please file feature requests and bugs at the issue tracker.

Libraries

unities_helper