The master branch is under active development and functionality may change or break at any time!
master
10.0 9.1
show older versions 9.0 8.1 8.0 7.3 7.2 7.1 7.0 6.3 6.2 6.1 6.0 5.7 5.6 5.5 5.4 5.3 5.2 5.1 5.0 4.5 3.6
Learn more

Humanizer

The humanizer class helps you bring a human touch to your application.

Usage

Files

The fileSize method converts a file size in bytes to a more human friendly format.

$this->humanizer->fileSize(1024); // Will return "1 KiB"

It will return binary suffixes by default can also make it output file sizes using decimal suffixes by setting the optional second parameter to false.

$this->humanizer->fileSize(1024, false); // Will return "1.02 KB"

Dates

The day method will return a human friendly representation of the day. If the day isn't within the yesterday/today/tomorrow range then it'll return the date in the format specified by the optional second parameter.

$this->humanizer->day(Time::now()); // Will return "today"

$this->humanizer->day(Time::now()->rewind(60*60*24)); // Will return "yesterday"

$this->humanizer->day(Time::now()->forward(60*60*24)); // Will return "tomorrow"

The time method will return a human friendly representation of the time. If the time isn't within the yesterday/today/tomorrow range then it'll return the time in the format specified by the optional second parameter. There is also a third parameter that lets you set the clock format.

$this->humanizer->time(Time::now()); // Will return "a minute ago"

$this->humanizer->time(Time::now()->rewind(60*4)); // Will return "4 minutes ago"

$this->humanizer->time(Time::now()->rewind(60*60)); // Will return "today, 08:43"

$this->humanizer->time(Time::now()->rewind(60*60*24)); // Will return "yesterday, 08:43"

$this->humanizer->time(Time::now()->forward(60*4)); // Will return "in 4 minutes"

$this->humanizer->time(Time::now()->forward(60*60)); // Will return "today, 10:43"

$this->humanizer->time(Time::now()->forward(60*60*24)); // Will return "tomorrow, 10:43"

Both the day and time methods use the I18n class so you can translate the strings to your own language if needed.