0.0.1 • Published 1 year ago

any-unit-converter v0.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

any-unit-converter

Description

A unit converter package allows users to convert values from one unit of measurement to another. It is designed to provide a convenient and easy-to-use solution for converting a wide range of units across various categories.

Installing

 $ npm install any-unit-converter@latest

Importing

  // Using Node.js 'require()'
  const uc = require(`any-unit-converter`);

  // Using ES6 imports
  import uc from 'any-unit-converter';

  // You can use different type of unit to pass into the function by importing their type.
  import UNIT_TYPE from 'any-unit-converter';
  import Area from 'any-unit-converter';

  // Example
   uc.convert(1,Area.SquareMeter,Area.SquareKiloMeter,UNIT_TYPE.AREA);

   # Convert square meter to square kilometer
   /// 1.00e+6

  - For detailed example refer usage section

Supported Units

1. Area ( area )

UnitAbbriviation
Square kilometerkm²
Square meter
Square milemi²
Square yardyd²
Square footft²
Square inchin²
Hectareha
Acreac

2. Data Transfer Rate ( data-transfer-rate )

UnitAbbriviation
Bit per secondbps
Kilobit per secondkbps
Kilobyte per secondKB/s
Kibibit per secondKibps
Megabit per secondMbps
Megabyte per secondMB/s
Mebibit per secondMib/s
Gigabit per secondGbps
Gigabyte per secondGB/s
Gibibit per secondGib/s
Terabit per secondTbpss
Terabyte per secondTB/s
Tebibit per secondTib/s

3. Digital Storage ( digital-storage )

UnitAbbreviation
Bitb
Kilobitkb
KibibitKibit
MegabitMb
MebibitMibit
GigabitGb
GibibitGibit
TerabitTb
TebibitTibit
PetabitPb
PebibitPibit
ByteB
KilobytekB
KibibyteKiB
MegabyteMB
MebibyteMiB
GigabyteGB
GibibyteGiB
TerabyteTB
TebibyteTiB
PetabytePB
PebibytePiB

4. Energy (energy)

UnitAbbriviation
JouleJ
KilojoulekJ
Gram caloriecal
Kilocaloriekcal
Watt hourWh
Kilowatt hourkWh
ElectronvolteV
British thermal unitBTU
US thermthm
Foot-poundft-lb

5. Frequency (frequency)

UnitAbbriviation
HertzHz
KilohertzkHz
MegahertzMHz
GigahertzGHz

6. Fuel Economics (fuel-economics)

UnitAbbriviation
Miles per gallonmpg
Miles per gallon (Imperial)mpgimp
Kilometer per literkm/L
Liter per 100 kilometersL/100km

7. Length (length)

UnitAbbriviation
Kilometerkm
Meterm
Centimetercm
Millimetermm
Micrometersum
Nanometernm
Milemi
Yardyd
Footft
Inchin
Nautical milenmi

8. Mass (mass)

UnitAbbriviation
Tonnet
Kilogramkg
Gramg
Milligrammg
Microgramug
Imperial tonlong-ton
US tonshort-ton
Stonest
Poundlb
Ounceoz

9. Plane angle (plane-angle)

UnitAbbriviation
Arcsecondarcsec
Degree°
Gradiangrad
Milliradianmrad
Minute of arcarcmin
Radianrad

10. Pressure (pressure)

UnitAbbriviation
BarBar
PascalPa
Pound per square inchpsi
Standard atmosphereatm
TorrmmHg

11. Speed (speed)

UnitAbbriviation
Mile per hourmph
Foot per secondfps
Meter per secondm/s
Kilometer per hourkm/h
Knotkt

12. Temperature (temperature)

UnitAbbriviation
Degree CelsiusC
FahrenheitF
KelvinK

13. Time (time)

UnitAbbriviation
Nanosecondns
Microsecondus
Millisecondms
Seconds
Minutemin
Hourh
Dayd
Weekwk
Monthmo
Calendar yearyr
Decadedec
Centurycen

14. Volume (volume)

UnitAbbriviation
US liquid gallonshort-gal
US liquid quartshort-qt
US liquid pintshort-pt
US legal cupUScp
Fluid ouncefl-oz
US tablespoonshort-tbsp
US teaspoonshort-tsp
Cubic meter
LiterL
MillilitermL
Imperial gallonlong-gal
Imperial quartlong-qt
Imperial pintlong-pt
Imperial cuplong-cp
Imp. fluid ouncelong-oz
Imperial tablespoonlong-tbsp
Imperial teaspoonlong-tsp
Cubic footft³
Cubic inchin³

Usage

Note: Use above mentioned name to convert value in different unit.

  import UNIT_TYPE from 'any-unit-converter';
  import Area from 'any-unit-converter';
  import DataTransferRate from 'any-unit-converter';
  import DigitalStorage from 'any-unit-converter';
  import Energy from 'any-unit-converter';
  import FuelEconomics from 'any-unit-converter';
  import Length from 'any-unit-converter';
  import Mass from 'any-unit-converter';
  import PlaneAngle from 'any-unit-converter';
  import Pressure from 'any-unit-converter';
  import Temperature from 'any-unit-converter';
  import Time from 'any-unit-converter';
  import Volume from 'any-unit-converter';

  // ~ Convert square meter to square kilometer
  console.log(uc.convert(1,Area.SquareMeter,Area.SquareKiloMeter,UNIT_TYPE.AREA)); /// 1.00e+6
  
  // ~ Convert Kilobyte per second to Kilobit per second
  console.log(uc.convert(16,DataTransferRate.KiloBytePerSecond,DataTransferRate.KilobitPerSecond,UNIT_TYPE.DATA_TRANSFER_RATE)); /// 128
  
  // ~ Convert Kibibit to Kilobit
  console.log(uc.convert(19.2,DigitalStorage.Kibibit,DigitalStorage.Kilobit,UNIT_TYPE.DIGITAL_STORAGE)); /// 19.6608
  
  // ~ Convert Kilojoule to Joule
  console.log(uc.convert(1.2,Energy.Kilojoule,Energy.Joule,UNIT_TYPE.ENERGY)); /// 1200
  
  // ~ Convert Gigahertz to Megahertz
  console.log(uc.convert(500,Frequency.Gigahertz,Frequency.Megahertz,UNIT_TYPE.FREQUENCY)); /// 500000
  
  // ~ Convert Gigahertz to Megahertz
  console.log(uc.convert(5.6,FuelEconomics.KilometerPerLiter,FuelEconomics.MilesPerGallonImperial,UNIT_TYPE.FUEL_ECONOMICS)); /// 15.818941
  
  // ~ Convert meter to centimeter
  console.log(uc.convert(1,Length.Meter,Length.Centimeter,UNIT_TYPE.LENGTH)); /// 100
  
  // ~ Convert Milligram to Gram
  console.log(uc.convert(50,Mass.Milligram,Mass.Gram,UNIT_TYPE.MASS)); /// 0.05
  
  // ~ Convert Gradian to Arcsecond
  console.log(uc.convert(6.50,PlaneAngle.Gradian,PlaneAngle.Arcsecond,UNIT_TYPE.PLANE_ANGLE)); /// 21060
  
  // ~ Convert Pascal to Bar
  console.log(uc.convert(1.1,Pressure.Pascal,Pressure.Bar,UNIT_TYPE.PRESSURE)); /// 1.100e-5
  
  // ~ Convert Foot per second to Mile per hour
  console.log(uc.convert(1000,Speed.FootPerSecond,Speed.MilePerHour,UNIT_TYPE.SPEED)); /// 681.818182
  
  // ~ Convert Fahrenheit to Degree Celsius
  console.log(uc.convert(50,Temperature.Fahrenheit,Temperature.DegreeCelsius,UNIT_TYPE.TEMPERATURE)); /// 10
  
  // ~ Convert Hour to Millisecond
  console.log(uc.convert(150,Time.Hour,Time.Millisecond,UNIT_TYPE.TIME)); /// 5.400e+8
  
  // ~ Convert US liquid gallon to US legal cup
  console.log(uc.convert(60,Volume.USLiquidGallon,Volume.USLegalCup,UNIT_TYPE.VOLUME)); /// 946.3525

Authors

  • WeeTech Solution PVT LTD

Stay in touch

License