ember-convert-units

A simple Ember addon for converting between units.

Table of Contents

• Installing
• Usage
• Supported Units

Installing

Run this command in your project

ember install ember-convert-units

Usage

This addon can be used in two ways

• Pure Function
• Template Helper

Pure Function

/*
 @param {number} quantity
 @param {string} units
 @param {string} newUnits
 @returns {number} The quantity expressed in the new units
*/

function convertUnits(quantity, units, { to: newUnits }) { ... }

Example

import { convertUnits } from 'ember-convert-units';

convertUnits(2, 'pounds', { to: 'grams' }); // 907.18474
convertUnits(5, 'mi', { to: 'km' }); // 8.04672

Template Helper

{{!--
  @param {number} quantity
  @param {string} units
  @param {string} newUnits 
  @returns {number} The quantity expressed in the new units
--}}

{{convert-units quantity units to=newUnits}}

Example

{{convert-units 2 'pounds' to='grams'}} grams
{{convert-units 5 'mi' to='km'}} km

generates the text

907.18474 grams
8.04672 km

Supported Units

For more details see register-units.js.

Length

Unit	Names
Nanometers	nanometres, nanometers, nm
Micrometers	micrometres, micrometers, μm
Millimeters	millimetres, millimeters, mm
Centimeters	centimetres, centimeters, cm
Meters	metres, meters, m
Kilometers	kilometres, kilometers, km
Inches	inches, in
Feet	feet, ft
Yards	yards, yd
Miles	miles, mi

Mass

Unit	Names
Micrograms	micrograms, μg
Milligrams	milligrams, mg
Grams	grams, g
Killograms	kilograms, kg
Tonnes	tonnes, metric ton
Tons (US)	tons, ton
Ounces	ounces, oz
Pounds	pounds, lb

Time

Unit	Names
Nanoseconds	nanoseconds, ns
Microseconds	microseconds, µs
Milliseconds	milliseconds, ms
Seconds	seconds, s
Minutes	minutes, min
Hours	hours, h

Temperature

Unit	Names
degrees Fahrenheit	degrees Fahrenheit, deg F, fahrenheit
degrees Celsius	degrees Celsius, deg C, celsius
Kelvin	kelvin

Speed

Unit	Names
Meters per Second	m/s
Meters per Hour	m/h
Kilometers per Hour	km/h, kph
Feet per Second	ft/s
Feet per Hour	ft/h
Miles per Hour	mi/h, mph

Pressure

Unit	Names
Nanopascals	nanopascals, npa
Micropascals	micropascals, μpa
Millipascals	millipascals, mpa
Centipascals	centipascals, cpa
Pascals	pascals, pa
Kilopascals	kilopascals, kpa
Nanobars	nanobars, nbar
Microbars	microbars, μbar
Millibars	millibars, mbar
Centibars	centibars, cbar
Bars	bars, bar
Kilobars	kilobars, kbar
Pounds per Square Inch	psi
Atmosphere	atmosphere, at

Volume

Unit	Names
Litres	litres, liters, L, l
Millilitres	millilitres, milliliters, ml, mL
Gallons	gallons, gal
Quart	quart, qt
Pint	pint, pt
Fluid Ounces	fluid ounces, fl oz
Acre Inch	acre inch, acre in, acre*in, acre*inch
Acre Foot	acre foot, acre ft, acre*ft, acre*foot

Not currently supported

• Area
• Digital Storage
• Data Transfer Rate

Feel free to contribute new units if you need them!