Relative Time
CommunityA timezone-aware table column for Filament v4 that renders GitHub’s <relative-time> element with safe, panel-scoped assets and a server-side fallback.
Author:
Relisiuol
Package health
BetaAutomated checks of this plugin's Composer package
13 checks
-
Warning:
Current Laravel version supported
—
Package does not co-install with current Laravel
13.0; the newest co-installable line is12.0, which still receives active support but is not the current stable. -
Passed:
Current PHP version supported
—
Constraint
^8.2supports current PHP8.5. - Skipped: Current Symfony version supported
- Passed: Abandoned or archived — No consulted source marks the package abandoned (packagist, github).
- Warning: Commit and release recency — Low activity: last commit 254 days ago; last release 254 days ago.
-
Passed:
composer.lock not committed by library
—
composer.lockis absent from the released dist archive. - Passed: Dist archive is lean
- Failed: GitHub Actions pinned to SHA — View details on Plumb
- Passed: Open security advisories
- Passed: Dependabot PR responsiveness — No open Dependabot PRs.
- Failed: Dependabot or Renovate configured — No dependency updater configuration found. View details on Plumb
- Skipped: Dependency update cooldown configured
- Failed: Provides a security policy — View details on Plumb
filament/
namespace. Review the source and install at your own risk. Found
malware or an unresolved security issue the author won't
address?
Report it
.
Documentation
A Filament v4 table column powered by @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.
#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
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 <html lang> / 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 <relative-time> 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. All options are defined as null, to use default options from@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 & submission
- Hosted on GitHub, distributed via Packagist.
- Public documentation in
docs/. - No CDN; CSP-friendly (serve the local bundle from your domain).
#License
MIT. Dependency: @github/relative-time-element (MIT).
Featured Plugins
A selection of plugins curated by the Filament team
Custom Dashboards
Let your users build and share their own dashboards with a drag-and-drop interface. Define your data sources in PHP and let them do the rest.
Filament
Advanced Tables (formerly Filter Sets)
Supercharge your tables with powerful features like user-customizable views, quick filters, multi-column sorting, advanced table searching, convenient view management, and more. Compatible with Resource Panel Tables, Relation Managers, Table Widgets, and Table Builder!
Kenneth Sese
Blueprint
Filament Blueprint is a premium Laravel Boost extension that helps AI agents produce accurate, detailed implementation plans and security reports for Filament apps.
Filament
