PHPackages                             realodix/timezone - 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. realodix/timezone

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

realodix/timezone
=================

A PHP library that provides an easy way to generate HTML select boxes for timezones.

v0.1.2(1y ago)03.3k↓78.4%MITPHPPHP ^8.1CI passing

Since Mar 7Pushed 2mo ago1 watchersCompare

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

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

Realodix\\Timezone
==================

[](#realodixtimezone)

[![PHPVersion](https://camo.githubusercontent.com/f1314f86ce41e6dc7a2d2b32419d8d7b37945e64a1f611c39a3c54312c97bc44/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312d3737374242342e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/f1314f86ce41e6dc7a2d2b32419d8d7b37945e64a1f611c39a3c54312c97bc44/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312d3737374242342e7376673f7374796c653d666c61742d737175617265)[![GitHub license](https://camo.githubusercontent.com/8c9ba9ee424ea9e85816eb69ad10f2f49775abb9d9da82c63e464c6d4143c96d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7265616c6f6469782f74696d657a6f6e653f7374796c653d666c61742d737175617265)](/LICENSE)

A PHP library that provides an easy way to generate HTML select boxes for timezones. It offers features to filter timezones by continent, group them, display offsets, and customize the output.

Features
--------

[](#features)

- **Comprehensive Timezone List:** Generates a complete list of all available timezones.
- **Array Representation:** Retrieves timezones as an array, suitable for use in any PHP application.
- **Continent-Based Grouping:** Optionally groups timezones by continent for better organization.
- **Flexible Filtering:** Includes or excludes specific continents/groups based on your needs.
- **UTC Offset Display:** Displays timezone offsets (e.g., UTC+05:30) for easy reference.

Installation
------------

[](#installation)

You can install this package via Composer:

```
composer require realodix/timezone
```

### Project status & release process

[](#project-status--release-process)

While this library is still under development, it is well tested and should be stable enough to use in production environments.

The current releases are numbered `0.x.y`. When a non-breaking change is introduced (adding new methods, optimizing existing code, etc.), `y` is incremented.

**When a breaking change is introduced, a new `0.x` version cycle is always started.** It is therefore safe to lock your project to a given release cycle, such as `0.1.*`. If you need to upgrade to a newer release cycle, check the [release history](https://github.com/realodix/timezone/releases) for a list of changes introduced by each further `0.x.0` version.

Usage
-----

[](#usage)

### Create HTML select box

[](#create-html-select-box)

```
/**
 * @param string $name The name attribute of the select tag
 * @param string|null $selected The value of the option to be pre-selected
 * @param array|null $attrs Additional HTML attributes
 */
public function toSelectBox(string $name, ?string $selected = null, ?array $attrs = null): string
```

```
use Realodix\Timezone\Timezone;

$tz = new Timezone;
$attributes = ['class' => 'form-control', 'id' => 'timezone-select'];

// Generate a select box with the name "timezone", pre-selecting "America/New_York",
// and using the specified attributes.
$tz->toSelectBox('timezone', 'America/New_York', $attributes);
```

Output:

```

        (UTC+00:00) UTC

    ...

        ...
        (UTC-05:00) Nassau
        (UTC-05:00) New York
        (UTC-09:00) Nome
        ...

    ...

        (UTC+03:00) Aden
        (UTC+05:00) Almaty
        ...

    ...

```

### Create timezone list array

[](#create-timezone-list-array)

```
use Realodix\Timezone\Timezone;

$tz = new Timezone;
$tz->toArray();
```

Output:

```
[
    'UTC' => '(UTC+00:00) UTC',
    'America' => [
        'Nassau' => '(UTC-05:00) Nassau',
        'New_York' => '(UTC-05:00) New York',
        'Nome' => '(UTC-09:00) Nome'
        // ...
    ],
    // ...
]
```

### Filtering and Grouping Timezones

[](#filtering-and-grouping-timezones)

`Realodix\Timezone` provides a powerful set of methods to customize the timezone list:

- `onlyGroups(array $groups)`: Includes only the specified continent/group names. For example, `$tz->onlyGroups(['America', 'Europe'])` will return only the timezones within the America and Europe continents.
- `excludeGroups(array $groups)`: Excludes the specified continent/group names. For example, `$tz->excludeGroups(['Arctic'])` will omit all timezones from Arctic.
- `flatten()`: Flattens the timezone list, removing the continental grouping.
- `omitOffset()`: Removes the UTC offset from the displayed timezone names.

**Timezone Groups**

The `onlyGroups()` and `excludeGroups()` methods utilize timezone groups to filter the list. Here are the available groups:

- **General:** For the `UTC` timezone.
- Africa
- America
- Antarctica
- Arctic
- Asia
- Atlantic
- Australia
- Europe
- Indian
- Pacific

**Explanation:** Timezones are organized into groups, mainly based on continents. The `General` group contains only the `UTC` timezone. You can use these groups with the filtering methods.

**Examples:**

```
use Realodix\Timezone\Timezone;

$tz = new Timezone;
// Only include timezones from the America and Europe groups.
$tz->onlyGroups(['America', 'Europe'])->toArray();

// Output:
// [
//     'America' => [
//         'Nassau' => '(UTC-05:00) Nassau',
//         'New_York' => '(UTC-05:00) New York',
//         // ...
//     ],
//     'Europe' => [
//         'London' => '(UTC+00:00) London',
//         // ...
//     ],
// ]

// Exclude timezones from the Arctic and Africa groups.
$tz->excludeGroups(['Arctic', 'Africa'])->toArray();

// Output (will not include any timezones from the Arctic or Africa groups):
// [
//     'General' => [
//         'UTC' => '(UTC+00:00) UTC'
//     ]
//     'America' => [
//         'Nassau' => '(UTC-05:00) Nassau',
//         'New_York' => '(UTC-05:00) New York',
//         // ...
//     ],
//     // ...
// ]
```

License
-------

[](#license)

This package is licensed using the [MIT License](/LICENSE).

###  Health Score

37

—

LowBetter than 82% of packages

Maintenance72

Regular maintenance activity

Popularity21

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

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

Total

3

Last Release

401d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/01bfff23a3bc54204b47bee797a13a438df9156915ad177258dbd1a9f110f5b7?d=identicon)[KeiJR](/maintainers/KeiJR)

---

Top Contributors

[![realodix](https://avatars.githubusercontent.com/u/1314456?v=4)](https://github.com/realodix "realodix (9 commits)")

---

Tags

timezonetimezone-list

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/realodix-timezone/health.svg)

```
[![Health](https://phpackages.com/badges/realodix-timezone/health.svg)](https://phpackages.com/packages/realodix-timezone)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M680](/packages/barryvdh-laravel-ide-helper)[orchestra/canvas

Code Generators for Laravel Applications and Packages

21017.2M157](/packages/orchestra-canvas)[illuminate/pipeline

The Illuminate Pipeline package.

9446.6M210](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10532.5M855](/packages/illuminate-pagination)[spatie/laravel-pjax

A pjax middleware for Laravel 5

513371.8k11](/packages/spatie-laravel-pjax)[spatie/laravel-mix-preload

Add preload and prefetch links based your Mix manifest

169176.0k2](/packages/spatie-laravel-mix-preload)

PHPackages © 2026

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