Skip to content

Latest commit

 

History

History
176 lines (134 loc) · 4.29 KB

README.md

File metadata and controls

176 lines (134 loc) · 4.29 KB
Raw

ember-convert-units

A simple Ember addon for converting between units.

Table of Contents

Installing

Run this command in your project

ember install ember-convert-units

Usage

This addon can be used in two ways

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!