Download the PHP package jessedp/php-timezones without Composer
On this page you can find all versions of the php package jessedp/php-timezones. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package php-timezones
php-timezones
A wrapper to enumerate PHP 5.6+, 7.x, 8.x timezones in a simplified way for use in various ways.
This is done with Laravel 5.5+ in mind - YMMV elsewhere.
Basics
- Creates timezone arrays based on PHP's supported timezones with optional grouping by region
- Lists are sorted by offset from high (+14:00) to low (-11:00)
- Optionally group the arrays (multi-dim associated array) by region
- sorting is the same, but only inside each region
- For either case, return those as:
- php arrays for whatever use your heart desires
- HTML select list
- 2 utility functions for converting to/from UTC
Installation
You can install this package using Composer.
Usage
1. Render a timezone HTML Select list
The method Timezones::create()
has three parameters:
- $name required - the name of the select element
- $selected - sets the selected value of list box, assuming the a value with the option exists
- $opts an array of options as key=>value:
- attr => array of key=>value pairs to be included in the select element (ie, 'id', 'class', etc.)
- withregions => _boolean whether or not to use option groups for the regions/continents (defaults to false)
- regions => array (of strings) specifying the region(s) to include
Basic Example
Returns a string similar to:
"Selected" Example
Same as above, but _Asia/Ho_ChiMinh will be selected by default
"Options" Example
You may also add multiple attributes with an array.
Which gives us:
"Regions/Grouping" Example
Say you want the option groups but only a couple regions...
This will return a string similar to the following:
2. Render a timezone array
You can also render timezone list as an array. To do so, just use the Timezones::toArray()
method.
Example in Laravel:
3. Utility methods
The package includes two methods that make it easy to deal with displaying and storing timezones, convertFromUTC()
and convertToUTC()
:
Each function accepts two required parameters and a third optional parameter dealing with the format of the returned timestamp.
The first parameter accepts a timestamp, the second accepts the name of the timezone that you are converting to/from. The option values associated with the timezones included in the select form builder can be plugged into here as is. Alternatively, you can use any of PHP's supported timezones.
The third parameter is optional, and default is set to 'Y-m-d H:i:s'
, which is how Laravel natively stores datetimes into the database (the created_at
and updated_at
columns). If you're using this for display purposes, you may find including '(e)'
in the format string which displays the timezone.
Thanks to
This is based off some lovely work by:
The Spatie group and specifically the laravel-analytics project I used as inspiration copied for structure