README

This library helps to format the date/time interval into text.

Examples

Notice that not every translator supports weeks, months and years

Usage

DateTimeAgo class has public method get. It accepts 1 required argument (\DateTime object) and 1 optional (reference date. If it is null, current time is used).

<?php
    $date_ago = new \Smirik\PHPDateTimeAgo\DateTimeAgo();
    $date_ago->get(new \DateTime('-24 hours')); /* returns "1 day ago" */
    $date_ago->get(new \DateTime('-69 minutes')); /* returns "1 hour ago" */
    $date_ago->get(new \DateTime('-100 minutes')); /* returns "2 hours ago" */
    $date_ago->get(new \DateTime('-155 minutes')); /* returns "3 hours ago" */

Russian translation:

<?php
    $date_ago = new \Smirik\PHPDateTimeAgo\DateTimeAgo(new \Smirik\PHPDateTimeAgo\TextTranslator\RussianTextTranslator());
    $date_ago->get(new \DateTime('-24 hours')); /* returns "1 день назад" */
    $date_ago->get(new \DateTime('-69 minutes')); /* returns "1 час назад" */
    $date_ago->get(new \DateTime('-100 minutes')); /* returns "2 часа назад" */
    $date_ago->get(new \DateTime('-155 minutes')); /* returns "3 часа назад" */

Customization

Date formatter for more than 6 days

<?php
    ...
    $date_ago->setFormat('d.m.Y H:i:s');

This setup date in format 01.01.2001 22:52:12.

Custom translator

The DateTimeAgo constructor accept TextTranslator file as the first argument. By default EnglishTextTranslator is provided. You can add your custom translator to this constructor. Just make sure that your class implements Smirik\PHPDateTimeAgo\TextTranslator\TextTranslatorInterface. There is also standard way for translations based on pluralization procedure. The methods are already implemented for any language in AbstractTextTranslator class. English & Russian samples are already included in this package. You can also change the translator after creation:

<?php
    ...
    $date_ago->setTextTranslator(new \Smirik\PHPDateTimeAgo\TextTranslator\RussianTextTranslator());

Implementation

How to integrate library with Symfony2

Tests

Most parts of the code are tested via phpspec. To run the tests clone the repository and run

$ php bin/phpspec run

Development workflow

In order to keep git versioning accurate please use git-flow pattern.
So all pull requests except hotfix should go to the develop branch.
Hotfix should go to both development branches: develop & master at the same time.

Contribution

Any contribution is welcome.

Acknowledgements

Symfony cookbook for Russian pluralization rule.

smirik / php-datetime-ago

Maintainers

Details