0.5.1 • Published 9 years ago
easy-converter v0.5.1
easy-converter
The ambitious, easy to use unit converter
Introduction
easy-converter is a unit converter that will handle weight, length, area (..) conversions.
For now it supports:
- Length (distance)
- Mass (weight)
- Area
- Computer storage
Installation:
npm install --save easy-converter
Test:
npm run test
or
npm test
Example:
var easyconverter = require('easy-converter');
var c = new easyconverter();
c.convert(1, 'cm').to('m');The converter will return NaN in case of an unauthorized conversion.
c.convert(1, 'cm').to('b');
// => NaNSupported units :
Distance
| Unit | Abbreviation in easy-converter |
|---|---|
| mil | mil |
| inch | in |
| foot | ft |
| yard | yd |
| mile | mi |
| capefoot | cp |
| rod | rd |
| angstrom | A |
| nanometer | n |
| micron | µ |
| millimeter | mm |
| centimeter | cm |
| meter | m |
| kilometer | km |
| light-year | ly |
| light-day | ld |
| light-hour | lh |
| light-minute | lm |
| light-second | ls |
Weight
| Unit | Abbreviation in easy-converter |
|---|---|
| carat (metric) | ct |
| point (metric) | pt |
| dram (avdp) | adr |
| dram (troy) | tdr |
| grain (metric) | mgr |
| grain (troy) | tgr |
| gram | g |
| hundredweight (long) | lhwt |
| hundredweight (short) | shwt |
| kilogram | kg |
| megagram | Mg |
| milligram | mg |
| ounce (avdp) | aoz |
| ounce (troy) | toz |
| pennyweight | dwt |
| pound (avdp) | alb |
| pound (metric) | lb |
| pound (troy) | tlb |
| slug | slug |
| stone | st |
| ton-assay (long) | lAT |
| ton-assay (short) | sAT |
| ton (long) | ltn |
| ton (short) | stn |
| ton-metric | t |
| tonne (U.S. metric ton) | t |
Area
| Unit | Abbreviation in easy-converter |
|---|---|
| square inch | in2 |
| square foot | ft2 |
| square yard | yd2 |
| square mile | mi2 |
| acre | ac |
| hectare | ha |
| square millimeter | mm2 |
| square centimeter | cm2 |
| square meter | m2 |
| square kilometer | km2 |
Computer storage
| Unit | Abbreviation in easy-converter |
|---|---|
| bit | b |
| kilobit | kb |
| megabit | Mb |
| gigabit | Gb |
| terabit | Tb |
| petabit | Pb |
| exabit | Eb |
| zettabit | Zb |
| yottabit | Yb |
| nibble | nibble |
| byte | B |
| kilobyte | kB |
| megabyte | MB |
| gigabyte | GB |
| terabyte | TB |
| petabyte | PB |
| exabyte | EB |
| zettabyte | ZB |
| yottabyte | YB |
How to contribute
Just fork and create a PR! Try to match the coding style and indentation (2 spaces tabs) of the files in this repository.
To add a new converter just add add a module in lib/converters that exports an object containing units as keys and ratios as value the reference unit should have the value of 0.
Example:
module.exports = {
"a": 1,
"b": 2,
"c": 3
}This means b == 2 a and c == 3 a
Credits
Furey, Edward "Conversion Calculators" From http://www.CalculatorSoup.com - Online Calculator Resource. For the amazing formulas
