PHPackages arraypress/wp-timezones - 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. arraypress/wp-timezones ActiveLibrary[Utility & Helpers](/categories/utility) arraypress/wp-timezones ======================= A lightweight WordPress library for working with timezone data and utilities. 01PHP Since Jan 22Pushed 5mo agoCompare [ Source](https://github.com/arraypress/wp-timezones)[ Packagist](https://packagist.org/packages/arraypress/wp-timezones)[ RSS](/packages/arraypress-wp-timezones/feed)WikiDiscussions main Synced today READMEChangelogDependenciesVersions (1)Used By (0) WordPress Timezones =================== [](#wordpress-timezones) A lightweight PHP library for working with timezone data in WordPress. Simple, static methods for timezone identifiers, regions, offsets, and utilities. Features -------- [](#features) - 🕐 Complete PHP timezone list (400+ timezones) - 🌍 Region grouping and filtering - 🎯 Simple static API - no instantiation needed - 📝 Multiple output formats for dropdowns - 🔍 Search and validation utilities - ⏰ UTC offset calculation and formatting - 🎨 Gutenberg/React compatible formats Installation ------------ [](#installation) ``` composer require arraypress/wp-timezones ``` Basic Usage ----------- [](#basic-usage) ``` use ArrayPress\Timezones\Timezones; // Get all timezones $timezones = Timezones::all(); // Returns: ['Africa/Abidjan', 'Africa/Accra', ...] // Get formatted label $label = Timezones::get_label( 'America/New_York' ); // "America/New York" // Check if timezone exists if ( Timezones::exists( 'Europe/London' ) ) { // Valid timezone } // Validate and sanitize user input $timezone = Timezones::sanitize( $_POST['timezone'] ); // "America/New_York" or null ``` Dropdown Options ---------------- [](#dropdown-options) ``` // Gutenberg/React format (value/label) $options = Timezones::get_value_label_options(); // Returns: [['value' => 'America/New_York', 'label' => 'America/New York'], ...] // Key/value format $options = Timezones::get_key_value_options(); // Returns: ['America/New_York' => 'America/New York', ...] // With empty option $options = Timezones::get_value_label_options( true, '— Select Timezone —' ); // With UTC offset in labels $options = Timezones::get_options_with_offset(); // Returns: [['value' => 'America/New_York', 'label' => '(UTC-05:00) America/New York'], ...] // Grouped by region $grouped = Timezones::get_grouped_options(); // Returns: ['America' => [['value' => 'America/New_York', 'label' => 'New York'], ...], ...] ``` UTC Offsets ----------- [](#utc-offsets) ``` // Get offset in seconds $offset = Timezones::get_offset( 'America/New_York' ); // -18000 // Get formatted offset string $offset = Timezones::get_offset_string( 'America/New_York' ); // "-05:00" $offset = Timezones::get_offset_string( 'Asia/Kolkata' ); // "+05:30" ``` Regions ------- [](#regions) ``` // Get region from timezone $region = Timezones::get_region( 'America/New_York' ); // "America" // Get city from timezone $city = Timezones::get_city( 'America/New_York' ); // "New York" // Get all regions $regions = Timezones::get_regions(); // Returns: ['Africa', 'America', 'Antarctica', 'Arctic', 'Asia', 'Atlantic', 'Australia', 'Europe', 'Indian', 'Pacific'] // Get timezones by region $american = Timezones::get_by_region( 'America' ); // Get region options for dropdown $options = Timezones::get_region_options(); ``` Search ------ [](#search) ``` // Search by identifier $results = Timezones::search( 'york' ); // Returns: ['America/New_York'] // Search with limit $results = Timezones::search( 'america', 5 ); ``` Helper Functions ---------------- [](#helper-functions) Global functions are available for convenience: ``` // Get formatted label $label = get_timezone_label( 'America/New_York' ); // "America/New York" // Get UTC offset $offset = get_timezone_offset( 'America/New_York' ); // -18000 // Get formatted offset string $offset = get_timezone_offset_string( 'America/New_York' ); // "-05:00" // Get region $region = get_timezone_region( 'America/New_York' ); // "America" // Get dropdown options $options = get_timezone_options(); // Get all regions $regions = get_timezone_regions(); // Validate timezone if ( is_valid_timezone( 'Europe/London' ) ) { // Valid } // Sanitize user input $timezone = sanitize_timezone( $_POST['timezone'] ); ``` API Reference ------------- [](#api-reference) MethodDescriptionReturn`all()`Get all timezones`array``exists($timezone)`Check if exists`bool``sanitize($timezone)`Validate/sanitize`?string``get_label($timezone)`Get formatted label`string``get_region($timezone)`Get region`string``get_city($timezone)`Get city/location`string``get_offset($timezone)`Get UTC offset (seconds)`?int``get_offset_string($timezone)`Get formatted offset`string``get_regions()`Get all regions`array``get_by_region($region)`Timezones in region`array``search($term, $limit)`Search timezones`array``get_options($format, $empty, $label)`Get dropdown options`array``get_key_value_options($empty, $label)`Key/value format`array``get_value_label_options($empty, $label)`Value/label format`array``get_options_with_offset($empty, $label)`Options with UTC offset`array``get_grouped_options()`Grouped by region`array``get_region_options($empty, $label)`Region dropdown options`array`Requirements ------------ [](#requirements) - PHP 7.4 or higher - WordPress 6.0 or higher License ------- [](#license) GPL-2.0-or-later ### Health Score 17 — LowBetter than 6% of packages Maintenance49 Moderate activity, may be stable Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity13 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/cd6eb8aff0903d87eb674d1ba3c5f3653899c0d7661504eb0deb7798ed86b643?d=identicon)[arraypress](/maintainers/arraypress) --- Top Contributors [![arraypress](https://avatars.githubusercontent.com/u/22668877?v=4)](https://github.com/arraypress "arraypress (3 commits)") ### Embed Badge ![Health badge](/badges/arraypress-wp-timezones/health.svg) ``` [![Health](https://phpackages.com/badges/arraypress-wp-timezones/health.svg)](https://phpackages.com/packages/arraypress-wp-timezones) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)