/human-readable-unit

human readable units

Primary LanguagePHP

human units

what?

A php library to format units.

how?

Duration

$duration = \HumanUnit\Duration::seconds(86462);
echo $duration->humanize(); // '1d 1m 2s'

Distance

$distance = \HumanUnit\Distance::nano_meters(intval(2 + 1e9 + 1e12));
echo $distance->humanize(); // '1km 1m 2nm'

Cardinality

$quantity = \HumanUnit\Cardinality::kilo(1002);
echo $quantity->humanize(); // '1M 2k'

Bit

$memory_size = \HumanUnit\Bit::bytes(1024);
echo $memory_size->humanize(); // '1kB 24B'

From human representation

$distance = \HumanUnit\Distance::from_human('1km 1m 2nm');
echo $distance->humanize(); // '1km 1m 2nm'

Comparisons

$_1km = \HumanUnit\Distance::from_human('1km');
$_1000m = \HumanUnit\Distance::from_human('1000m');
$_500m = \HumanUnit\Distance::from_human('500m');
assert($_1km == $_1000m);
assert($_1km > $_500m);