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.1.0 2025-06-18 10:49 UTC

Requires

• php: ^8.1

Requires (Dev)

• laravel/pint: ^1.18.3
• phpstan/phpstan: ^2.0.3
• phpunit/phpunit: ^10.5.38
• squizlabs/php_codesniffer: ^3.11.1
• symfony/var-dumper: ^6.4.15

MIT

• Serhii Cho

• library
• date
• html
• datetime
• time ago

README

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, and I'll fix it as soon as I can.

Follow the official documentation for more information

Supported Languages

Flag	Language	ISO 639-1
🇬🇧	English	en
🇷🇺	Russian	ru
🇺🇦	Ukrainian	uk
🇳🇱	Dutch	nl
🇩🇪	German	de
🇨🇳	Chinese Simplified	zh

Quick Start

composer require serhii/ago

License

The Ago project is licensed under the MIT License

Contribute

With Container Engine

Note

If you use 🐳 Docker instead of 🦦 Podman, just replace podman-compose with docker compose, and podman with docker in code examples below.

Build an Image

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

podman-compose build app

Run the Container

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

podman-compose run --rm app

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 run this:

podman-compose down