converter - Convert between different units of measurement #

A Dart library for converting between different units of measurement for various quantities

Usage #

See example/main.dart

Length

final Length l1 = Length(2, 'm'); // 2 metres
final Length l2 = Length(37, 'cm'); // 37 centimetres
final Length l3 = Length(3.7, 'dm'); // 3.7 decimetres

final num l2ValueInInches = l2.valueIn('in');
// l2ValueInInches ~= 14.566929

final Length sum = l1 + l2;
// sum == 2370 millimetres

final Length difference = l1 - l2;
// difference ~= 5.347769 feet

final bool l1EQl2 = l1 == l2;
// l1EQl2 == false

final bool l2EQl3 = l2 == l3;
// l2EQl3 == true

final bool l1GTl2 = l1 > l2;
// l1GTl2 == true

final bool l1LTEl2 = l1 <= l2;
// l1LTEl2 == false

Time

final Time t1 = Time.si(86400); // 86400 seconds
final Time t2 = Time(24, 'h'); // 24 hours
final Time t3 = Time(1500, 'min'); // 1500 minutes

final num t3ValueInDays = t3.valueIn('d');
// t3ValueInDays ~= 1.041667

final Time sum = t1 + t2;
// sum == 2880 minutes

final Time difference = t3 - t2;
// difference == 3600 seconds

final bool t1EQt2 = t1 == t2;
// t1EQt2 == true

final bool t2EQt3 = t2 == t3;
// t2EQt3 == false

final bool t3GTt2 = t3 > t2;
// t3GTt2 == true

final bool t3LTEt2 = t3 <= t2;
// t3LTEt2 == false

Supported quantities and units #

Length #

• m - metre (SI)
• dm - decimetre
• cm - centimetre
• mm - millimetre
• µm - micrometre
• nm - nanometre
• dam - decametre
• hm - hectometre
• km - kilometre
• Mm - megametre
• Gm - gigametre
• Å - ångström
• in - inch
• ft - foot
• yd - yard
• mi - mile
• nmi - nautical mile

Mass #

• kg - kilogram (SI)
• hg - hectogram
• dag - decagram
• g - gram
• dg - decigram
• cg - centigram
• mg - milligram
• µg - microgram
• ng - nanogram
• Mg - megagram
• Gg - gigagram
• oz - ounce
• lb - pound
• t - tonne or metric ton
• long-ton | ton - long ton or imperial ton
• short-ton - short ton

Time #

• s - second (SI)
• ds - decisecond
• cs - centisecond
• ms - millisecond
• µs - microsecond
• ns - nanosecond
• das - decasecond
• hs - hectosecond
• ks - kilosecond
• Ms - megasecond
• Gs - gigasecond
• min - minute
• h - hour
• d - day
• wk - week
• fn - fortnight
• mo - month
• y - year
• dec - decade
• c - century

Temperature #

• K - kelvin (SI)
• C - degree Celsius
• F - degree Fahrenheit
• R - degree Rankine

Area #

• m2 - square metre (SI)
• dm2 - square decimetre
• cm2 - square centimetre
• mm2 - square millimetre
• µm2 - square micrometre
• dam2 - square decametre
• hm2 | ha - square hectometre or hectare
• km2 - square kilometre
• Mm2 - square megametre
• in2 - square inch
• ft2 - square foot
• mi2 - square mile
• ac - acre

Force #

• N - newton (SI)
• dyn - dyne
• gf - gram-force
• kgf - kilogram-force
• lbf - pound-force
• pdl - poundal

Frequency #

• Hz - hertz (SI)
• kHz - kilohertz
• MHz - megahertz
• GHz - gigahertz
• THz - terahertz
• rad/s - radian per second
• deg/s - degree per second
• rpm - revolutions per minute

SolidAngle #

• sr - steradian (SI)
• deg2 - square degree

Speed #

• m/s - metre per second (SI)
• km/h - kilometre per hour
• ft/s - foot per second
• mi/h - mile per hour
• kn - knot

Syntax #

See documentation for more

License #

MIT