PHP timezone_abbreviations_list() Function

Beginner
5 min read
Updated: Nov 2026
3 examples
Date/Time

Definition

In PHP, timezone_abbreviations_list() returns a big array that describes the time zone abbreviations PHP knows about, such as est, pst and cet.

Each key is a lowercase abbreviation. Each value is a list of entries that tell you whether the abbreviation means daylight saving time, its offset from UTC in seconds, and the full time zone identifier it belongs to. It is the procedural version of DateTimeZone::listAbbreviations().

Syntax

Call timezone_abbreviations_list() with the values you need. Start with this line.

PHP
$abbr = timezone_abbreviations_list();
CallWhat it does
timezone_abbreviations_list()Returns every abbreviation PHP knows, grouped by lowercase name.
timezone_abbreviations_list()['est']Returns the list of entries that match the abbreviation EST.
DateTimeZone::listAbbreviations()The object-oriented version that returns the same array.

The function takes no arguments. The array keys are always lowercase, so look up 'est' and not 'EST'. One abbreviation can map to several zones, which is why each key holds a list of entries.

Library declarations
PHP
timezone_abbreviations_list(): array

Parameters

ParameterDescription
—This function takes no parameters.

Return Value

Return ValueDescription
arrayAn array keyed by lowercase abbreviation. Each value is a list of arrays with the keys dst (bool), offset (int, in seconds) and timezone_id (string or null).

PHP Examples

Example 1 — Looking Up an Abbreviation

The returned array is large, so we do not print all of it. Instead we check that it is an array and look for a few well-known abbreviations.

PHP
<?php
$abbr = timezone_abbreviations_list();

var_dump(is_array($abbr));
var_dump(isset($abbr['est']));
var_dump(isset($abbr['utc']));
echo gettype($abbr['est']), PHP_EOL;

How It Works

  1. timezone_abbreviations_list() returns the complete list in one array.
  2. is_array() confirms the return type.
  3. isset() checks whether a key such as est or utc exists.
  4. Each abbreviation holds an array of entries, so gettype() prints array.

Example 2 — Reading the Fields of One Entry

Each entry has the same three fields. This example reads the first entry for est and checks the type of each field.

PHP
<?php
$abbr = timezone_abbreviations_list();

$entry = $abbr['est'][0];

echo implode(', ', array_keys($entry)), PHP_EOL;
var_dump(is_bool($entry['dst']));
var_dump(is_int($entry['offset']));

How It Works

  1. $abbr['est'] is a list, so [0] selects its first entry.
  2. array_keys() shows the field names: dst, offset and timezone_id.
  3. dst is a boolean that says whether the abbreviation is for daylight saving time.
  4. offset is an integer number of seconds from UTC.

Example 3 — Keys Are Lowercase

A common mistake is to search for an abbreviation in uppercase. This example shows why that does not work.

PHP
<?php
$abbr = timezone_abbreviations_list();

var_dump(array_key_exists('PST', $abbr));
var_dump(array_key_exists('pst', $abbr));
var_dump(count($abbr['pst']) > 0);
var_dump(array_key_exists('xyz', $abbr));

How It Works

  1. The key PST in uppercase does not exist, because PHP stores every key in lowercase.
  2. The lowercase key pst exists.
  3. count() shows that pst holds at least one entry.
  4. An unknown abbreviation such as xyz is simply not a key in the array.

Frequently Asked Questions

It returns an array of all the time zone abbreviations PHP knows, with the offset, daylight saving flag and time zone identifier for each one.
PHP stores every abbreviation in lowercase in this array. When you look something up, use strtolower() on your value first so that EST and est both work.
The same short code can mean different places. IST, for example, is used in more than one country. Each entry shows one possible meaning, with its own offset and zone identifier.
Yes. The function is the procedural alias of the DateTimeZone::listAbbreviations() static method, and both return the same array.
It is better to use full identifiers like Europe/London or Asia/Kolkata. Identifiers know the daylight saving rules, while abbreviations can be ambiguous.

Next: timezone_identifiers_list()

timezone_identifiers_list() returns an array of time zone identifiers, such as Europe/Lond.

timezone_identifiers_list() tutorial →

About the author

Mari Selvan M P
Mari Selvan M P 🔗

Developer, cloud engineer, and technical writer

  • Experience 12 years building web and cloud systems
  • Focus Full Stack Development, AWS, and Developer Education

I write practical tutorials so students and working developers can learn by doing—from databases and APIs to deployment on AWS.

8 people found this page helpful