PHPackages joaopaulolndev/filament-world-clock - 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 & Helpers](/categories/utility) 4. / 5. joaopaulolndev/filament-world-clock ActiveLibrary[Utility & Helpers](/categories/utility) joaopaulolndev/filament-world-clock =================================== Show hours around the world by timezone v3.0.2(2mo ago)3111.9k↓31.4%7MITPHPPHP ^8.2CI passing Since Jun 17Pushed 1mo ago3 watchersCompare [ Source](https://github.com/joaopaulolndev/filament-world-clock)[ Packagist](https://packagist.org/packages/joaopaulolndev/filament-world-clock)[ Docs](https://github.com/joaopaulolndev/filament-world-clock)[ GitHub Sponsors](https://github.com/joaopaulolndev)[ RSS](/packages/joaopaulolndev-filament-world-clock/feed)WikiDiscussions 3.x Synced 1mo ago READMEChangelog (10)Dependencies (18)Versions (21)Used By (0) Filament widget to show hours around the world by timezone ========================================================== [](#filament-widget-to-show-hours-around-the-world-by-timezone) [![Latest Version on Packagist](https://camo.githubusercontent.com/3bdbb9414f193a8a07a921de11706f7b3e616d7a689688153e0f8b76e09a4068/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a6f616f7061756c6f6c6e6465762f66696c616d656e742d776f726c642d636c6f636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/joaopaulolndev/filament-world-clock)[![GitHub Tests Action Status](https://camo.githubusercontent.com/0a1ceadb0a1f8d4cf2ec2e8595300a44cf49933ad2b4905cb73089ada6bf8f74/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6f616f7061756c6f6c6e6465762f66696c616d656e742d776f726c642d636c6f636b2f72756e2d74657374732e796d6c3f6272616e63683d322e78266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/joaopaulolndev/filament-world-clock/actions?query=workflow%3Arun-tests+branch%3A2.x)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/3c6d8391c2397e24bd1e2c27ffbb48a4335fe03a51a9df1f47e10f7d71a77ed0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6f616f7061756c6f6c6e6465762f66696c616d656e742d776f726c642d636c6f636b2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d322e78266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/joaopaulolndev/filament-world-clock/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3A2.x)[![Total Downloads](https://camo.githubusercontent.com/0ab77706b7684287d8dff3db08c5a3a1c08a93802753a0124443774fed6e25f8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6f616f7061756c6f6c6e6465762f66696c616d656e742d776f726c642d636c6f636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/joaopaulolndev/filament-world-clock) The Filament World Clock plugin designed to showcase global timezones in a card format is a user-friendly tool that allows users to effortlessly display current times across various regions worldwide. [![Screenshot of Application Feature](https://raw.githubusercontent.com/joaopaulolndev/filament-world-clock/2.x/art/joaopaulolndev-filament-world-clock.jpg)](https://raw.githubusercontent.com/joaopaulolndev/filament-world-clock/2.x/art/joaopaulolndev-filament-world-clock.jpg) Compatibility ------------- [](#compatibility) Package VersionFilament Version1.x3.x2.x4.x3.x5.xInstallation ------------ [](#installation) You can install the package via composer: ``` composer require joaopaulolndev/filament-world-clock:^3.0 ``` Note to publish the assets is necessary to run the command below: ``` php artisan vendor:publish --tag=filament-world-clock-assets --force ``` Optionally, you can publish the views using ``` php artisan vendor:publish --tag="filament-world-clock-views" ``` Optionally, you can publish the translations using ``` php artisan vendor:publish --tag="filament-world-clock-translations" ``` You can publish the flags Note to publish the flags is necessary to run the command below: ``` php artisan vendor:publish --tag=blade-flags --force ``` Usage ----- [](#usage) Add in AdminPanelProvider.php ``` use Joaopaulolndev\FilamentWorldClock\FilamentWorldClockPlugin; ->plugins([ FilamentWorldClockPlugin::make() ->timezones([ 'America/New_York', 'America/Sao_Paulo', 'Asia/Tokyo', ]) ]) ``` Optionally, you can add more configs as example below: ``` use Joaopaulolndev\FilamentWorldClock\FilamentWorldClockPlugin; FilamentWorldClockPlugin::make() ->timezones([ 'America/New_York', 'America/Sao_Paulo', 'Asia/Tokyo', ]) ->setTimeFormat('H:i') //Optional time format default is: 'H:i' ->shouldShowTitle(false) //Optional show title default is: true ->setTitle('Hours') //Optional title default is: 'World Clock' ->setDescription('Different description') //Optional description default is: 'Show hours around the world by timezone' ->setQuantityPerRow(1) //Optional quantity per row default is: 1 ->setColumnSpan('full') //Optional column span default is: '1/2' ->setSort(10) ``` ### Custom Flags [](#custom-flags) Flags are automatically resolved for all valid PHP timezones using `DateTimeZone::getLocation()`. If you need to override a specific timezone flag, you can use the `customFlags()` method: ``` FilamentWorldClockPlugin::make() ->timezones([ 'America/New_York', 'America/Denver', 'Pacific/Guam', ]) ->customFlags([ 'America/Denver' => '/path/to/custom-flag.svg', 'Pacific/Guam' => asset('images/guam-flag.svg'), ]) ``` Note Custom flags take the highest priority. For timezones without a country code (e.g. `Etc/UTC`), a placeholder flag is used as fallback. Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [João Paulo Leite Nascimento](https://github.com/joaopaulolndev) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 55 — FairBetter than 98% of packages Maintenance88 Actively maintained with recent releases Popularity38 Limited adoption so far Community19 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits 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 ~33 days Recently: every ~1 days Total 20 Last Release 76d ago Major Versions v1.0.10 → v2.0.02025-08-09 v2.0.0 → v3.0.02026-01-20 v1.0.11 → v2.0.22026-03-04 v2.0.2 → v3.0.22026-03-04 PHP version history (2 changes)v1.0.0PHP ^8.1 v3.0.0PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/6bc80e83b4acca3d0efddfb786ec3a1265c7076e398d3a0e164917753e571d4b?d=identicon)[joaopaulolndev](/maintainers/joaopaulolndev) --- Top Contributors [![joaopaulolndev](https://avatars.githubusercontent.com/u/11706937?v=4)](https://github.com/joaopaulolndev "joaopaulolndev (25 commits)")[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (18 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (12 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (6 commits)")[![edeoliv](https://avatars.githubusercontent.com/u/76831154?v=4)](https://github.com/edeoliv "edeoliv (2 commits)")[![TonyOsadolor](https://avatars.githubusercontent.com/u/81017184?v=4)](https://github.com/TonyOsadolor "TonyOsadolor (1 commits)")[![PrashantDhungana](https://avatars.githubusercontent.com/u/29656761?v=4)](https://github.com/PrashantDhungana "PrashantDhungana (1 commits)")[![bilogic](https://avatars.githubusercontent.com/u/946010?v=4)](https://github.com/bilogic "bilogic (1 commits)") --- Tags laraveljoaopaulolndevfilament-world-clock ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/joaopaulolndev-filament-world-clock/health.svg) ``` [![Health](https://phpackages.com/badges/joaopaulolndev-filament-world-clock/health.svg)](https://phpackages.com/packages/joaopaulolndev-filament-world-clock) ``` ### Alternatives [joaopaulolndev/filament-general-settings Filament package to manage general settings 18129.7k](/packages/joaopaulolndev-filament-general-settings)[guava/calendar Adds support for vkurko/calendar to Filament PHP. 298241.0k3](/packages/guava-calendar)[bezhansalleh/filament-google-analytics Google Analytics integration for FilamentPHP 205144.8k5](/packages/bezhansalleh-filament-google-analytics)[jibaymcs/filament-tour Bring the power of DriverJs to your Filament panels and start a tour ! 12247.8k](/packages/jibaymcs-filament-tour)[marcelweidum/filament-expiration-notice Customize the livewire expiration notice 9169.0k4](/packages/marcelweidum-filament-expiration-notice)[hydrat/filament-table-layout-toggle Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts. 6292.3k1](/packages/hydrat-filament-table-layout-toggle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)