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(7mo ago)72.5k2[1 PRs](https://github.com/php-ago/ago/pulls)MITPHPPHP ^8.1CI failing

Since Oct 23Pushed 5mo 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 today

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)

### 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 up -d
```

With Docker:

```
docker compose up -d
```

### Enter The Container

[](#enter-the-container)

With Podman:

```
podman-compose exec app bash
```

With Docker:

```
docker compose exec app bash
```

### Install Composer Dev Dependencies

[](#install-composer-dev-dependencies)

After you entered the container, run `composer install` to install all development dependencies like phpunit, phpstan, etc.

### 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

50

—

FairBetter than 95% of packages

Maintenance69

Regular maintenance activity

Popularity26

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 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

220d 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://avatars.githubusercontent.com/u/35465417?v=4)[Serhii Cho](/maintainers/SerhiiCho)[@SerhiiCho](https://github.com/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.8M24](/packages/league-period)[brick/date-time

Date and time library

3663.8M108](/packages/brick-date-time)[zjkal/time-helper

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

21031.3k2](/packages/zjkal-time-helper)[danielstjules/php-pretty-datetime

Generates human-readable strings for PHP DateTime objects

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

PHPackages © 2026

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