Mezur

Converting any measuring unit to any unit

Sometimes you want to convert hours to seconds. Something you want to know how many weeks are in a decade. And sometimes, you want to know how many blinks of an eye are in a day...

Installation

npm install mezur --save

Usage example

const time = require('mezur/time')
time.hours(5).inSeconds() // 18000
time.decades(1).inWeeks() // 521.4285714285714

Also exposes the timeunit methods directly

const { hours, minutes } = require('mezur/time')
hours(3).inDays() // 0.125
minutes(60).inHours() // 1

Also possible is .asHours() or .toHours()

same for

require('mezur/angles')
require('mezur/area')
require('mezur/mass')
require('mezur/length')
require('mezur/pressure')
require('mezur/time')

There are other unit conversion packages, what gives?

Some of the other packages only give you partial conversions (i.e. minutes to seconds) without anything else. Some are great, but are not complete, so you need several packages to "collect the whole set" Some are more "complete" but without an easy way to add more units.

Building this is with intent to provide as much flexibility and extendability as possibly while keeping an easy-on-the-eyes usage, since you want to an easy and reliable API when converting, so it won't get in the way of your other important code. I believe that hours(5).inSeconds() do just that (to as much as javascript can give)

Supported Conversions

Acceleration

name	symbol	value
centigal	cgal	0.0001mpsps
centigalileo	cgali	0.0001mpsps
centimeterPerSecPerSec	cmpsps	0.01mpsps
feetPerHourPerHour	ftphph	0.00000002351852mpsps
feetPerHourPerMin	fphpmin	0.000001411mpsps
feetPerHourSec	fphps	0.000084667mpsps
feetPerMinPerMin	ftpmpm	0.000084667mpsps
feetPerMinutePerSec	fpmps	0.00508mpsps
feetPerSecPerSec	ftpsps	0.3048mpsps
gUnits	gu	9.80665mpsps
gal	gal	0.01mpsps
galileo	gali	0.01mpsps
gravity	g	9.80665mpsps
inchPerHourPerHour	inphph	0.000000001959877mpsps
inchPerHourPerMin	iphpm	0.0000001175926mpsps
inchPerHourPerSecond	iphps	0.000007055556mpsps
inchPerMinPerMin	inpmpm	0.000007055556mpsps
inchPerMinPerSec	ipmps	0.000423333mpsps
inchPerSecPerSec	inpsps	0.0254mpsps
kilogal	kgal	10mpsps
kilogalileo	kgali	10mpsps
kilometerPerSecPerSec	kmpsps	1000mpsps
knotsPerHour	knphph	0.0001429012mpsps
knotsPerMillisec	knpmspms	514.444444444444mpsps
knotsPerMin	knpmpm	0.00857407407407407mpsps
knotsPerSec	knpsps	0.514444444444444mpsps
metersPerHourPerHour	mphph	0.00000007716049mpsps
metersPerMinPerMin	mpmpm	0.000277778mpsps
metersPerSecPerSec	mpsps	1
milePerHourPerHour	miphph	0.000124178mpsps
milesPerMinPerMin	mipmpm	0.44704mpsps
milesPerSecPerSec	mipsps	1609.344mpsps
milligal	mgal	0.00001mpsps
milligalileo	mgali	0.00001mpsps
millimeterPerSecPerSec	mmpsps	0.001mpsps

Angles

name	symbol	value
arcMinute	arcmin	1deg / 60
arcSecond	arcsec	1deg / 3600
degree	deg	1
gradian	grad	0.9deg
hourAngle	hrang	15deg
milliradian	mrad	0.001rad
quadrant	qd	90deg
radian	rad	1deg * 180/3.141592653589793
sextant	sxt	60deg
turn	tr	360deg

Area

name	symbol	value
acre	acre	4046.856430051sqm
are	a	100sqm
cent	cn	40.468564301sqm
centiare	ca	0.1sqm
decare	daa	100sqm
deciare	da	10sqm
hectare	ha	10000
squareFeet	sqft	0.092903035sqm
squareInch	sqin	0.00064516sqm
squareKilometer	sqkm	1000000sqm
squareMeter	sqm	1
squareYard	sqy	.836127392sqm

Length

name	symbol	value
centimeter	cm	0.01m
feet	ft	12in
inch	in	0.0254m
kilometer	km	1000m
meter	m	1
micrometer	mcm	0.001mm
mile	ml	1.609344km
millimeter	mm	0.01cm
nanometer	nm	0.001mcm
nauticalMile	nml	1.852km
yard	yard	0.9144m

Mass

name	symbol	value
carat	ct	0.2g
grain	gr	0.06479891g
gram	g	1
imperialTon	impT	1016.05kg
jin	jin	0.002g
kilogram	kg	1000g
microgram	mcg	0.000001g
milligram	mg	0.001g
ounce	oz	28.349523125g
pound	lb	453.59237g
stone	st	6.35029318kg
ton	T	1000000g
usTon	usT	907.18474kg

Pressure

name	symbol	value
atmosphere	atm	1.01325000bar
bar	bar	1
pascal	pas	0.00001bar
psi	psi	0.06894757293bar
torr	tr	0.001333223684bar

Temperature

name	symbol	value
Celsius	C	1K + 273.15
Delisle	D	(1K - 373.15) * (-3 / 2)
Fahrenheit	F	(1K * 9 / 5) - 459.67
Kelvin	K	1
Newton	N	(1K - 273.15) * 33 / 100
Rankine	R	1K * 9 / 5

Time

name	symbol	value
century	C	10D
day	d	24h
decade	D	10Y
gigasecond	Gs	31Y + 287d
hectosecond	hs	1m + 40s
hour	h	60m
killosecond	ks	16m + 40s
megasecond	Ms	11d + 13h + 46m + 40s
millisecond	ms	0.001s
minute	m	60s
month	M	31d
second	s	1
terasecond	Ts	31600Y
week	w	7d
year	Y	365d

Development setup

yarn install
yarn test

How to extend Mezur?

Let's say you now landed on Mars, and obviously everything is in javascript because only hipsters live on Mars.

const marsUnits = [
  {
    name: 'martianDay', // or sol
    symbol: 'marsd',
    value: '24h + 39m + 35.244s'
  },
  {
    name: 'martianYear',
    symbol: 'marsY',
    value: '668.5991marsd'
  }
]

const timeUnits = require('./units/time.json') // note that angles is a js file, so PI calculates will be accurate

const marsTime = require('mezur')(timeUnits.concat(marsUnits))

marsTime.martianYears(1).inMartianDays() // 668.5991
marsTime.martianYears(1).inSeconds() // 59355048.240680404

Release History

see changelog.md

Meta

Guy Israeli – @isguyra

Distributed under the MIT license. See LICENSE for more information.

https://github.com/guyisra/mezur

Contributing

1. Fork it (https://github.com/guyisra/mezur)
2. Create your feature branch (git checkout -b feature/fooBar)
3. Commit your changes (git commit -am 'Add some fooBar')
4. Push to the branch (git push origin feature/fooBar)
5. Create a new Pull Request