PHPackages                             serhii/ago - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. serhii/ago

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

serhii/ago
==========

Transforms a given date into a human-readable "time ago" format with multilingual support. Example outputs include "1 hour ago", "2 days ago", "Just now", and "Online". The results are fully customizable to fit your specific needs

4.2.0(5mo ago)62.4k2[1 PRs](https://github.com/php-ago/ago/pulls)MITPHPPHP ^8.1CI passing

Since Oct 23Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/php-ago/ago)[ Packagist](https://packagist.org/packages/serhii/ago)[ Docs](https://php-ago.github.io/)[ RSS](/packages/serhii-ago/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (49)Used By (0)

[![Ago package](https://camo.githubusercontent.com/8bb66321edb002679edd13ef2beacdcb7f1353fd86750a4ee3fe1bb530219652/68747470733a2f2f73657268696963686f2e636f6d2f73746f726167652f6f746865722f61676f2e706e67)](https://camo.githubusercontent.com/8bb66321edb002679edd13ef2beacdcb7f1353fd86750a4ee3fe1bb530219652/68747470733a2f2f73657268696963686f2e636f6d2f73746f726167652f6f746865722f61676f2e706e67)

[![Ago](https://github.com/php-ago/ago/actions/workflows/php.yml/badge.svg?branch=master)](https://github.com/php-ago/ago/actions/workflows/php.yml)[![Total Downloads](https://camo.githubusercontent.com/5fe8f6c3386810f3c1d93f93b7506385d5b96aa5d5ba870edca28c70c61f1d25/68747470733a2f2f706f7365722e707567782e6f72672f7365726869692f61676f2f646f776e6c6f616473)](https://packagist.org/packages/serhii/ago)[![License](https://camo.githubusercontent.com/4c5090fc769772b7083c3c81424bbca1bd2603f45c34202077ac55c20dc641c6/68747470733a2f2f706f7365722e707567782e6f72672f7365726869692f61676f2f6c6963656e7365)](https://packagist.org/packages/serhii/ago)

Date/time converter into "n time ago" format that supports multiple languages, such as 🇷🇺 🇬🇧 🇳🇱 🇺🇦 🇩🇪. You can contribute any language that you wish easily by creating a pull request. When new PHP version comes out, this package will be updated to support it as soon as possible.

This package is well tested, optimized and already used in many production apps. It has shown itself pretty well. If you find any issues or bugs 🐞, please create an [issue](https://github.com/php-ago/ago/issues/new), and I'll fix it as soon as I can.

### Follow the [official documentation](https://php-ago.github.io/) for more information

[](#follow-the-official-documentation-for-more-information)

Supported Languages
-------------------

[](#supported-languages)

FlagLanguageISO 639-1🇬🇧English`en`🇷🇺Russian`ru`🇺🇦Ukrainian`uk`🇳🇱Dutch`nl`🇩🇪German`de`🇨🇳Chinese Simplified`zh`Quick Start
-----------

[](#quick-start)

```
composer require serhii/ago
```

License
-------

[](#license)

The Ago project is licensed under the [MIT License](https://github.com/php-ago/ago/blob/master/LICENSE)

Contribute
----------

[](#contribute)

### With Container Engine

[](#with-container-engine)

#### Build an Image

[](#build-an-image)

To build an image, navigate to the root of project and run this command.

With Podman:

```
podman-compose build
```

With Docker:

```
docker compose build
```

#### Run the Container

[](#run-the-container)

To run the container, navigate to the root of and run this command.

With Podman:

```
podman-compose run --rm app
```

With Docker:

```
docker compose run --rm app
```

#### Cleanup

[](#cleanup)

After you are done working on a project, you can cleanup and run the command below to remove things like created networks for the current project.

With Podman:

```
podman-compose down
```

With Docker:

```
docker compose down
```

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance75

Regular maintenance activity

Popularity25

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~48 days

Recently: every ~87 days

Total

47

Last Release

173d ago

Major Versions

1.3.2 → 2.02020-12-01

2.3.1 → 3.0.02022-01-27

3.2.6 → 4.0.0-rc.12024-12-11

PHP version history (3 changes)1.0.0PHP ^7.1

2.0.6PHP ^7.1|^8.0

4.0.0-rc.1PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/492847fa1c01ef11bfb489695d1d8553d4729f59efce19b34b8ed4b0f3598fae?d=identicon)[SerhiiCho](/maintainers/SerhiiCho)

---

Top Contributors

[![SerhiiCho](https://avatars.githubusercontent.com/u/35465417?v=4)](https://github.com/SerhiiCho "SerhiiCho (405 commits)")

---

Tags

converterconvertsdatetimepackagephptimetimeagolibraryhtmldatetimedatetime ago

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/serhii-ago/health.svg)

```
[![Health](https://phpackages.com/badges/serhii-ago/health.svg)](https://phpackages.com/packages/serhii-ago)
```

###  Alternatives

[league/period

Time range API for PHP

7335.4M21](/packages/league-period)[brick/date-time

Date and time library

3623.3M61](/packages/brick-date-time)[zjkal/time-helper

一个简单快捷的PHP日期时间助手类库。 a smart PHP datetime helper library.

21128.6k1](/packages/zjkal-time-helper)[danielstjules/php-pretty-datetime

Generates human-readable strings for PHP DateTime objects

5791.9k](/packages/danielstjules-php-pretty-datetime)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
