salernolabs/relative-time

Library for building relative time strings in PHP.

salernolabs/relative-time

, _(*1)

Library for building relative time strings in PHP., _(*2)

Usage

Installation

First include this project with composer, _(*3)

composer require salernolabs/relative-time

Formatting Time

Then run the formatter on a DateTime object., _(*4)

$formatter = new \SalernoLabs\RelativeTime\Formatter();
$relativeTime = $formatter->getRelativeTime(new \DateTime('-47 minutes'));
echo $relativeTime;

This would output '47 minutes ago'. The formatter will also go forward as well so if you put in '+47 minutes' it will say "47 mintues from now"., _(*5)

Examples of Time Reformatting

This library will also give short-hand conversational outputs for some values. For example:, _(*6)

And actual numbers for other times, for example:, _(*7)

HTML5 Tags

You can easily wrap the output in an html5 time tag by using the getRelativeTimeTag function., _(*8)

$formatter = new \SalernoLabs\RelativeTime\Formatter();
$relativeTime = $formatter->getRelativeTimeTag(new \DateTime('-47 minutes'));
echo $relativeTime;

This would output:, _(*9)

<time title="April 14th, 2017 - 4:14PM EDT">47 minutes ago</time>

Relative Time Clock

The relative time clock can give you a textual representation of a time of day., _(*10)

$clock = new \SalernoLabs\RelativeTime\Clock();

$time = $clock
    ->setTime(new \DateTime('7:47'))
    ->getTime();

echo $time; // a quarter to eight o'clock

Examples of Relative Clock Output