Unit Converter is a PHP library that makes unit converting a fairly simple an intuitive process.
$ composer require skoyah/unit-converter
The Unit Converter library is under Skoyah\Converter
namespace.
Once you have installed the Unit Converter library, converting from one unit of measurement to another is really simple.
First, create a new instance of the desired type and import the related class. The instance needs to accept two parameters - 1) a boolean for the quantity, and 2) a string for the unit of measurement.
Next, all you need is to call a to()
method and pass in the parameter for the convertion.
use Skoyah\Converter\Mass;
$mass = new Mass(1, 'kg');
echo $mass->to('pounds'); // '2.20462262'
Alternatively, you can convert using the unit abbreviation as a parameter:
echo $mass->to('lbs'); // '2.20462262'
The to()
method has also an optional parameter tor defining how many decimal units should be displayed for the given convertion.
echo $mass->to('lbs', 2); // '2.20'
Currently, the Unit Converter supports the following types:
During instantiation or convertion, you have two options for defining the unit to be used.
There is a longform and a short-hand word available for each unit of measure.
For consistency, it is recommended to use lowercase letters, but if you prefer you can use uppercase letters since during instantiation and/or convertion, the unit of measure will be parsed and formatted to lowercase characters.
long | short |
---|---|
tonnes | t |
kilograms | kg |
grams | g |
milligrams | mg |
pounds | lbs |
onces | oz |
long | short |
---|---|
kelvin | k |
celsius | c |
fahrenheit | f |
long | short |
---|---|
kilometers | km |
meters | m |
decimeters | dm |
centimeters | cm |
millimeters | mm |
inches | in |
feet | ft |
yards | yd |
miles | mi |
nautical miles | nmi |
long | short |
---|---|
bars | bar |
millibars | mbar |
kilopascals | kpa |
pascals | pa |
atmospheres | atm |
long | short |
---|---|
square kilometers | km2 |
square meters | m2 |
square centimeters | cm2 |
square millimeters | mm2 |
square inches | in2 |
square feet | ft2 |
square yards | yd2 |
long | short |
---|---|
cubic millimeters | mm3 |
cubic centimeter | cm3 |
cubic decimeter | dm3 |
cubic meter | m3 |
cubic dekameter | dam3 |
cubic hectometer | hm3 |
cubic kilometer | km3 |
In order to ensure that the community is welcoming to all, please review and abide by the Code of Conduct.
Unit Converter is released under the MIT Licence. Read the license file for more details.