PHPackages                             relisiuol/filament-relative-time - 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. relisiuol/filament-relative-time

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

relisiuol/filament-relative-time
================================

Filament 4 column powered by @github/relative-time-element.

v1.1.1(6mo ago)3720↑100%2[1 issues](https://github.com/relisiuol/filament-relative-time/issues)MITPHPPHP ^8.2

Since Oct 27Pushed 6mo agoCompare

[ Source](https://github.com/relisiuol/filament-relative-time)[ Packagist](https://packagist.org/packages/relisiuol/filament-relative-time)[ Docs](https://github.com/relisiuol/filament-relative-time)[ RSS](/packages/relisiuol-filament-relative-time/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (2)Versions (4)Used By (0)

Filament Relative Time
======================

[](#filament-relative-time)

A Filament v4 table column powered by [`@github/relative-time-element`](https://github.com/github/relative-time-element), bundled **locally** with esbuild. It renders relative, absolute (Intl) or duration values in the user's time zone (or a forced IANA time zone), with a SSR fallback.

**[Documentation](https://github.com/relisiuol/filament-relative-time/tree/v1.0.0/docs/index.md)**

Since v1.1 the column reuses the native `TextColumn` view, so helpers like `alignment()`, `wrap()`, copyable state, descriptions, etc. keep working while the formatted value is swapped with ``.

Quick install
-------------

[](#quick-install)

```
composer require relisiuol/filament-relative-time
php artisan vendor:publish --tag=filament-relative-time
```

Enable the plugin on your panel:

```
use Relisiuol\FilamentRelativeTime\RelativeTimePlugin;

public function panel(\Filament\Panel $panel): Panel
{
    return $panel->plugins([
        RelativeTimePlugin::make(),
    ]);
}
```

Column usage
------------

[](#column-usage)

```
use Relisiuol\FilamentRelativeTime\Columns\RelativeTimeColumn as RT;

RT::make('created_at')
  ->label('Created')
  ->format('relative')          // relative | datetime | duration
  ->precision('minute')         // for relative/duration
  ->threshold('P30D')           // ISO8601 – switch to absolute after 30 days
  ->timeZone('auto')            // 'auto' (browser) or 'Europe/Paris'
  ->locale('en-GB')             // otherwise  / browser
  ->datetimeIntl([              // only when format='datetime'
    'year'           => 'numeric',
    'month'          => 'short',
    'day'            => '2-digit',
    'hour'           => '2-digit',
    'minute'         => '2-digit',
    'time-zone-name' => 'short',
  ])
  ->formatStyle('short')        // 'long' | 'short' | 'narrow'
  ->tense('auto')               // 'auto' | 'past' | 'future'
  ->absolutePrefix('on')        // override default absolute prefix
  ->noTitle()                   // drop  title attribute
  ->elementAttributes(['aria-label'=>'Creation date']);
```

Need 12-hour output or no timezone suffix? Tweak `datetimeIntl()`, e.g. swap `'hour' => '2-digit'` for `'hour' => 'numeric'`, add `'second' => '2-digit'`, drop `'time-zone-name'`, or opt-in to `'date-style'` / `'time-style'` presets if your target browsers support them.

> Global defaults come from `config/filament-relative-time.php`. Publish the config and set keys like `'format-style' => 'short'` or `'prefix' => ''` to apply them across every column, including the default `time-zone` attribute. All options are defined as null, to use default options from [`@github/relative-time-element`](https://github.com/github/relative-time-element).

Other attributes from the Web Component (e.g. `prefix`, `format-style`, `tense`, `no-title`) are mapped with dedicated helpers or fall back to `elementAttributes([...])` for any edge-case attribute.

Quality &amp; submission
------------------------

[](#quality--submission)

- Hosted on GitHub, distributed via Packagist.
- Public documentation in `docs/`.
- No CDN; CSP-friendly (serve the local bundle from your domain).

License
-------

[](#license)

MIT. Dependency: `@github/relative-time-element` (MIT).

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance61

Regular maintenance activity

Popularity23

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 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 ~4 days

Total

3

Last Release

195d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6f26042161b8de258f75fa005f27a4d3ae45fc4cae0446c7baa8942632b5dfa0?d=identicon)[relisiuol](/maintainers/relisiuol)

---

Top Contributors

[![relisiuol](https://avatars.githubusercontent.com/u/49282232?v=4)](https://github.com/relisiuol "relisiuol (3 commits)")

---

Tags

laraveldatetimetablesfilamentfilamentphpcolumntimezoneweb-componentrelative-time

### Embed Badge

![Health badge](/badges/relisiuol-filament-relative-time/health.svg)

```
[![Health](https://phpackages.com/badges/relisiuol-filament-relative-time/health.svg)](https://phpackages.com/packages/relisiuol-filament-relative-time)
```

###  Alternatives

[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[omar-haris/filament-timezone-field

A Laravel Filament component that enables users to choose a specific timezone grouped by regions, with support for multiple languages.

1613.5k1](/packages/omar-haris-filament-timezone-field)[tomatophp/filament-icons

Picker &amp; Table Column &amp; Icons Provider for FilamentPHP

3598.2k13](/packages/tomatophp-filament-icons)[defstudio/filament-searchable-input

A searchable autocomplete input for Filament forms

3212.4k](/packages/defstudio-filament-searchable-input)[asosick/filament-layout-manager

Allow users to create &amp; customize their own FilamentPHP pages composed of Livewire components

5718.8k2](/packages/asosick-filament-layout-manager)

PHPackages © 2026

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