PHPackages nehero/friendlytimezone - 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. nehero/friendlytimezone ActiveLibrary[Utility & Helpers](/categories/utility) nehero/friendlytimezone ======================= Display timezones to your users in a friendly way using locations as names v3.0.2(4y ago)1374.2k↓32.4%1[1 PRs](https://github.com/ozziexsh/friendlytimezone/pulls)MITPHPPHP ^8.0 Since Dec 27Pushed 2y ago1 watchersCompare [ Source](https://github.com/ozziexsh/friendlytimezone)[ Packagist](https://packagist.org/packages/nehero/friendlytimezone)[ Docs](https://github.com/ozziexsh/friendlytimezone)[ RSS](/packages/nehero-friendlytimezone/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (2)Versions (10)Used By (0) User-friendly timezones for PHP =============================== [](#user-friendly-timezones-for-php) [![Latest Version on Packagist](https://camo.githubusercontent.com/f4a07604e707825ee380f7a6d8623d50f33e980b5de08c721f7c7c6f88cc5656/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e656865726f2f667269656e646c7974696d657a6f6e652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nehero/friendlytimezone)[![Total Downloads](https://camo.githubusercontent.com/6b4204ea6e89bd4d22034b1200abef4c07ddd3b6005ea5df3ca6084c6f247861/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e656865726f2f667269656e646c7974696d657a6f6e652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nehero/friendlytimezone)[![Tests](https://github.com/ozziexsh/friendlytimezone/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/ozziexsh/friendlytimezone/actions/workflows/run-tests.yml) List extracted from [Microsoft Time Zone Index Values](https://support.microsoft.com/en-ca/kb/973627). Some regions influenced by [this Stack Overflow answer](http://stackoverflow.com/a/12473225). > ⚠️ This package has been rewritten in version 3 to support more flexibility of working with the timezones as well as incorporating modern php features > > [If you are looking for the now deprecated version 2 documentation, click here](https://github.com/ozziexsh/friendlytimezone/tree/2.0.1) Installation ------------ [](#installation) As of v3.0 this package requires PHP 8.0+ You can install the package via composer: ``` composer require nehero/friendlytimezone ``` Usage ----- [](#usage) ``` // Illuminate\Support\Collection of Nehero\Timezone $timezones = Nehero\FriendlyTimezone\FriendlyTimezone::timezones(); // properties available to you foreach ($timezones as $timezone) { echo $timezone->friendlyName; // Saskatchewan (string) echo $timezone->timezone; // America/Regina (string) echo $timezone->offset; // -6 (int|float) echo $timezone->getFormattedOffset(); // -6:00 (string) } // common formatting for dropdowns $timezones->map(fn ($tz) => [ 'label' => "(UTC{$tz->getFormattedOffset()}) {$tz->friendlyName}"), // (UTC+6:00) Saskatchewan 'value' => $tz->timezone, // America/Regina ]); // need it in descending order? // can manipulate it however you want with // common collection or native array/iterable functions $timezones->sortByDesc(fn ($tz) => $tz->offset)->map(...); ``` Supported Timezones ------------------- [](#supported-timezones) See any missing? Pull requests and issues are welcome! Click to view a table of all currently supported timezonesIANA NameFriendly NamePacific/MidwayMidway Island, SamoaPacific/HonoluluHawaiiAmerica/AnchorageAlaskaAmerica/TijuanaPacific Time (US and Canada); Tijuana, Baja CaliforniaAmerica/EdmontonMountain Time (US and Canada)America/ChihuahuaChihuahua, La Paz, MazatlanAmerica/PhoenixArizonaAmerica/ChicagoCentral Time (US and Canada)America/ReginaSaskatchewanAmerica/Mexico\_CityGuadalajara, Mexico City, MonterreyAmerica/ManaguaCentral AmericaAmerica/New\_YorkEastern Time (US and Canada)America/Indiana/IndianapolisIndiana (East)America/BogotaBogota, Lima, QuitoAmerica/CaracasCaracasAmerica/HalifaxAtlantic Time (Canada)America/Argentina/San\_JuanGeorgetown, La Paz, San JuanAmerica/SantiagoSantiagoAmerica/ManausManausAmerica/AsuncionAsuncionAmerica/St\_JohnsNewfoundlandAmerica/Sao\_PauloBrasiliaAmerica/Argentina/Buenos\_AiresBuenos Aires, GeorgetownAmerica/GodthabGreenlandAmerica/MontevideoMontevideoAtlantic/South\_GeorgiaMid-AtlanticAtlantic/AzoresAzoresAtlantic/Cape\_VerdeCape Verde IslandsEurope/LondonGreenwich Mean Time: Dublin, Edinburgh, Lisbon, LondonAtlantic/ReykjavikMonrovia, ReykjavikAfrica/CasablancaCasablancaUTCCoordinated Universal TimeEurope/BelgradeBelgrade, Bratislava, Budapest, Ljubljana, PragueEurope/SarajevoSarajevo, Skopje, Warsaw, ZagrebEurope/ParisBrussels, Copenhagen, Madrid, ParisEurope/BerlinAmsterdam, Berlin, Bern, Rome, Stockholm, ViennaAfrica/LagosWest Central AfricaAsia/AmmanAmmanAsia/BeirutBeirutAfrica/CairoCairoEurope/MinskMinskEurope/HelsinkiHelsinki, Kiev, Riga, Sofia, Tallinn, VilniusEurope/AthensAthens, Bucharest, IstanbulAsia/JerusalemJerusalemAfrica/HarareHarare, PretoriaAfrica/WindhoekWindhoekEurope/MoscowMoscow, St. Petersburg, VolgogradAsia/KuwaitKuwait, RiyadhAfrica/NairobiNairobiAsia/BaghdadBaghdadAsia/TbilisiTbilisiAsia/TehranTehranAsia/MuscatAbu Dhabi, MuscatAsia/BakuBaku, Tbilisi, YerevanAsia/YerevanYerevanIndian/MauritiusPort LouisAsia/KabulKabulAsia/YekaterinburgEkaterinburgAsia/TashkentTashkentAsia/KarachiIslamabad, KarachiAsia/KolkataChennai, Kolkata, Mumbai, New DelhiAsia/KathmanduKathmanduAsia/DhakaAstana, DhakaAsia/ColomboSri JayawardenepuraAsia/AlmatyAlmaty, NovosibirskAsia/RangoonYangon (Rangoon)Asia/BangkokBangkok, Hanoi, JakartaAsia/KrasnoyarskKrasnoyarskAsia/Hong\_KongBeijing, Chongqing, Hong Kong, UrumqiAsia/Kuala\_LumpurKuala Lumpur, SingaporeAsia/TaipeiTaipeiAustralia/PerthPerthAsia/IrkutskIrkutsk, UlaanbaatarAsia/SeoulSeoulAsia/TokyoOsaka, Sapporo, TokyoAsia/YakutskYakutskAustralia/DarwinDarwinAustralia/AdelaideAdelaideAustralia/SydneyCanberra, Melbourne, SydneyAustralia/BrisbaneBrisbaneAustralia/HobartHobartAsia/VladivostokVladivostokPacific/GuamGuam, Port MoresbyAsia/MagadanMagadan, Solomon Islands, New CaledoniaPacific/FijiFiji, Kamchatka, Marshall Is.Pacific/AucklandAuckland, WellingtonAsia/KamchatkaPetropavlovsk-KamchatskyPacific/TongatapuNuku'alofaTesting ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) If you have a better suggestion for any of the mapped regions, please submit a pull request and include accurate sources for the changes. License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 40 — FairBetter than 88% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity38 Limited adoption so far Community11 Small or concentrated contributor base Maturity74 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 ~320 days Recently: every ~480 days Total 7 Last Release 1504d ago Major Versions 1.1 → 2.02016-12-31 2.0.1 → v3.0.02022-04-01 ### Community Maintainers ![](https://www.gravatar.com/avatar/43e611ddb2abd16c8563d49ae5a42933fd3d13ad41c73fd18b60708cf8c5b6c7?d=identicon)[nehero](/maintainers/nehero) --- Top Contributors [![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (9 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (8 commits)")[![ozziexsh](https://avatars.githubusercontent.com/u/2093630?v=4)](https://github.com/ozziexsh "ozziexsh (7 commits)") --- Tags laravelphptimezonetimezoneneheroozzieozziexshfriendlytimezone ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/nehero-friendlytimezone/health.svg) ``` [![Health](https://phpackages.com/badges/nehero-friendlytimezone/health.svg)](https://phpackages.com/packages/nehero-friendlytimezone) ``` ### Alternatives [brick/date-time Date and time library 3623.3M61](/packages/brick-date-time)[jamesmills/laravel-timezone Timezone storage and retrieval for Laravel 698764.1k12](/packages/jamesmills-laravel-timezone)[camroncade/timezone Helps manage timezones in Laravel. Includes <select> form builder for timezones. 162982.4k7](/packages/camroncade-timezone)[dater/dater Compact PHP library for working with date/time in different formats & timezones. 14282.3k](/packages/dater-dater)[icanboogie/datetime Extends the features of PHP DateTime and DateTimeZone 51345.7k3](/packages/icanboogie-datetime)[tapp/filament-timezone-field Filament timezone field. 55276.6k4](/packages/tapp-filament-timezone-field) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)