Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Generate textual time differences that are easily understandable by humans.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 examples
Octocat-spinner-32 src
Octocat-spinner-32 tests
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .travis.yml
Octocat-spinner-32 README.rst
Octocat-spinner-32 composer.json
Octocat-spinner-32 package.xml
Octocat-spinner-32 phpcs-ruleset.xml
README.rst

Date_HumanDiff

Generate textual time differences that are easily understandable by humans.

The class supports minutes, hours, days, weeks, months and years.

Examples:

  • 5 seconds ago -> just now
  • 65 seconds ago -> a minute ago
  • 120 seconds ago -> 2 minutes ago
  • a week ago
  • 3 weeks ago
  • a month ago
  • 8 months ago
  • a year ago
  • 5 years ago

Usage

<?php
require_once 'Date/HumanDiff.php';
$dh = new Date_HumanDiff();
echo $dh->get(time() - 3600);//shows "an hour ago"
echo $dh->get(time() + 3600 * 24, time()); //shows "tomorrow"

?>

Supported languages

  • German
  • English
  • Greek
  • Persian
  • Russian

Use a language with setLocale():

$dh = new Date_HumanDiff();
$dh->setLocale('de');
echo $dh->get(time() - 60 * 5) . "\n"; //shows "vor 5 Minuten"

Other libraries

https://github.com/azer/relative-date/blob/master/lib/relative-date.js
Javascript; library that's been used as base for Date_HumanDiff
https://github.com/rmm5t/jquery-timeago
Javascript; with localization options
http://pypi.python.org/pypi/py-pretty
Python
Something went wrong with that request. Please try again.