khandieyea/timegap

Timegap

, _(*1)

Change Log - 26/7/13 - Fixed typo in read me (thanks @davemfletcher), _(*2)

WHY?

Timegap as a time-passed or time-until helper that only shows relevant information. If something (such as a birthday) is 6 months away, do we really care about the seconds or minutes? I basically got sick of seeing things like:, _(*3)

Your next appointment is in 1 year, 3 months, 2 weeks, 4 days, 11 hours, 21 minutes, 11 seconds, _(*4)

That's pretty over exagerated, but you get the idea. Timegap is an attempt at solving this., _(*5)

Composer

https://packagist.org/packages/khandieyea/timegap, _(*6)

A usage example

Let's say your birthday is in 10 days:, _(*7)

$gap = Timegap::createThen('a datetime stamp or unix tick that is 10 days from now');

echo "Your birthday is in: ";
echo $gap->output('weeks, days, hours, minutes, seconds', 2);

At first, this will result in, _(*8)

Your birthday is in: 1 week, 4 days, _(*9)

As the gap closes say 6 days away, the 'weeks' will disappear and we will see hours, _(*10)

Your birthday is in: 6 days, 4 hours, _(*11)

Singular/plural words are taken care of, when your birthday is just over a day away, _(*12)

Your birthday is in: 1 day, 8 hours, _(*13)

As we get closer and there's less than 1 day to go, again day drops off and minutes appear, _(*14)

Your birthday is in: 4 hours, 46 minutes, _(*15)

And again, when under an hour to go, _(*16)

Your birthday is in: 24 minutes, 11 seconds, _(*17)

Dumb stuff you can do

$gap = new Timegap::createThen('a datetime stamp or tick that is 11 hours away');

echo "Your taxi will arrive in: ";
echo $gap->output('hours, minutes, seconds');
echo "<br />That's in precisely ";
echo $gap->output('seconds');

Would give you something like, _(*18)

Your taxi will arrive in: 10 hours, 59 minutes, 58 seconds, _(*19)

That's in precisely 39598 seconds, _(*20)