Everyone have written their share of trivial conversions - or less obvious ones where you need to Google that magic constant.
Stop littering your code with unnecessary calculations. Units.NET gives you all the common units of measurement and the conversions between them. It is light-weight, unit tested and supports PCL.
To install Units.NET, run the following command in the Package Manager Console or go to the NuGet site for the complete relase history.
Build Targets:
- .NET 3.5 Client
- Silverlight 4
- WinRT / .NET Core 4.5
- Portable Class Library (.NET 4.0 + Silverlight 4 + Windows Phone 7 + Xbox 360)
- Immutable structs for units of measurement, such as Length, Mass, Force and Pressure. See full list here.
- Convert between most popular units in the metric and imperial systems. See full list here.
- Choose between static (Length, Mass, Force etc.) or dynamic (UnitValue) representations for units of measurement.
- Parse abbreviation string to unit taking culture into account.
- Get abbreviation string for unit in different cultures.
// Stop postfixing your variables and method names with the unit...
double weightKg = GetPersonWeightInKg();
UpdatePersonWeightInGrams(weightKg * 1000);
// ...and start using a static representation for the measurement then
// explicitly convert to the unit of choice - when you need it.
Mass weight = GetPersonWeight();
UpdatePersonWeightInGrams(weight.Grams);
// Convert between compatible units of measurement...
Force scaleMeasurement = Force.FromNewtons(850);
Mass personWeight = Mass.FromGravitationalForce(scaleMeasurement);
double weightKg = personWeight.Kilograms;
// ...while avoiding confusing conversions, such as between weight and mass.
Mass weight = GetPersonWeight();
double weightNewtons = weight.Newtons; // No such thing.
// Some popular conversions.
Length meter = Length.FromMeters(1);
double cm = meter.Centimeters; // 100
double yards = meter.Yards; // 1.09361
double feet = meter.Feet; // 3.28084
double inches = meter.Inches; // 39.3701
Pressure p = Pressure.FromPascal(1);
double kpa = p.KiloPascals; // 1×10-3
double bar = p.Bars; // 1×10-5
double atm = p.Atmosphere; // 9.86923267×10-6
double psi = p.Psi; // 1.45037738×10-4
// Explicitly
double m = UnitConverter.Convert(1, Unit.Kilometer, Unit.Meter); // 1000
double mi = UnitConverter.Convert(1, Unit.Kilometer, Unit.Mile); // 0.621371
double yds = UnitConverter.Convert(1, Unit.Meter, Unit.Yard); // 1.09361
// Or dynamically.
UnitValue val = GetUnknownValueAndUnit();
// Returns false if conversion was not possible.
double cm;
val.TryConvert(Unit.Centimeter, out cm);
var f = Force.FromPressureByArea(Pressure p, Length2d area);
var f = Force.FromMassAcceleration(Mass mass, double metersPerSecondSquared);
var us = new CultureInfo("en-US");
var norwegian = new CultureInfo("nb-NO");
Unit.Tablespoon == UnitSystem.Create(us).Parse("tbsp")
Unit.Tablespoon == UnitSystem.Create(norwegian).Parse("ss")
"T" == UnitSystem.GetDefaultAbbreviation(Unit.Tablespoon, us)
"ss" == UnitSystem.GetDefaultAbbreviation(Unit.Tablespoon, norwegian)
- It is not an equation solver.
- It does not figure out the units after a calculation.
This project is still early and many units and conversions are not yet covered. If you are missing something, please help by contributing.
- Add more units.
- Not all conversions are unit tested yet.
- Parsing and getting textual representations not complete.
- Document all the data structures, units and conversions.
Please read the wiki on Adding a New Unit
and Adding a New Class of Units.
For other things to do, see Work In Progress.
Contact me if you have any questions.