【PHP8.x】timezone_identifiers_list関数の使い方

timezone_identifiers_list関数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年09月29日

基本的な使い方

timezone_identifiers_list関数は、システムで使用可能なタイムゾーン識別子のリストを取得する関数です。この関数は、PHPが認識できる全てのタイムゾーン名を配列で返します。引数として、特定の国または地域に関連するタイムゾーンのみをフィルタリングするための大陸コード（DateTimeZone::ALL、DateTimeZone::AFRICAなど）や、国コードを指定できます。これらの引数は省略可能であり、省略された場合は、全てのタイムゾーンが返されます。

システムエンジニアを目指す初心者にとって、タイムゾーンの扱いは重要な知識の一つです。なぜなら、アプリケーションが国際的に利用される場合、ユーザーの所在地に応じて適切な日時を表示したり、異なるタイムゾーン間で日時を変換したりする必要があるからです。timezone_identifiers_list関数を使用することで、アプリケーションでサポートすべきタイムゾーンをプログラム的に確認し、ユーザーに適切なタイムゾーンを選択肢として提供することが可能になります。

例えば、Webサイトの登録フォームでユーザーにタイムゾーンを選択させる場合、この関数を使ってタイムゾーンのリストを取得し、select要素の選択肢として表示できます。また、特定の地域に特化したサービスを提供する場合は、国コードを指定して、その地域に関連するタイムゾーンのみを表示することも可能です。この関数は、タイムゾーンを扱うPHPアプリケーション開発において、非常に便利なツールとなります。

構文(syntax)


1timezone_identifiers_list(int $what = DateTimeZone::ALL, ?string $country = null): array

引数(parameters)

?int $timezoneGroup = 2047, ?string $countryCode = null

int $timezoneGroup = 2047: タイムゾーンのグループを指定する整数。デフォルトは 2047 (すべてのグループ)。
?string $countryCode = null: 特定の国コードを指定する文字列。指定しない場合はすべてのタイムゾーンが返されます。

戻り値(return)

array

タイムゾーンの識別子として使用できる文字列の配列が返されます。

サンプルコード

PHP timezone_identifiers_list でタイムゾーン一覧を取得する


1<?php
2
3/**
4 * timezone_identifiers_list 関数を使用したサンプルコード
5 *
6 * 指定されたタイムゾーンのグループまたは国コードに基づいて、利用可能なタイムゾーン識別子のリストを取得します。
7 */
8
9// タイムゾーングループを指定してタイムゾーン識別子を取得
10$timezoneGroupIdentifiers = timezone_identifiers_list(DateTimeZone::ALL);
11
12// 国コードを指定してタイムゾーン識別子を取得 (例: 日本)
13$countryCodeIdentifiers = timezone_identifiers_list(DateTimeZone::ALL, 'JP');
14
15// 結果の表示
16echo "すべてのタイムゾーングループ:\n";
17print_r($timezoneGroupIdentifiers);
18
19echo "\n日本のタイムゾーン:\n";
20print_r($countryCodeIdentifiers);
21
22?>

timezone_identifiers_list 関数は、PHPで利用可能なタイムゾーン識別子のリストを取得するために使用します。この関数を使うことで、特定のタイムゾーングループや国に関連するタイムゾーンを絞り込むことができます。

引数 $timezoneGroup はオプションで、取得したいタイムゾーングループを指定します。例えば、DateTimeZone::ALL を指定すると、すべてのタイムゾーングループの識別子が返されます。この引数を省略した場合、デフォルト値の 2047 が使用され、これは事実上すべてのタイムゾーンを含むことを意味します。

もう一つのオプション引数 $countryCode は、国コードを指定します。例えば、'JP' を指定すると、日本に関連するタイムゾーン識別子のみが返されます。$timezoneGroup と $countryCode の両方を指定した場合、指定された国の指定されたタイムゾーングループに該当する識別子が返されます。

この関数は、タイムゾーン識別子の配列を返します。配列の各要素は文字列で、利用可能なタイムゾーンの名前を表します。例えば、'Asia/Tokyo' や 'America/Los_Angeles' などです。

サンプルコードでは、まず DateTimeZone::ALL を指定して、すべてのタイムゾーングループの識別子を取得しています。次に、国コード 'JP' を指定して、日本のタイムゾーン識別子を取得しています。最後に、print_r 関数を使って、取得したタイムゾーン識別子の配列を表示しています。このように、timezone_identifiers_list 関数を使うことで、アプリケーションで利用可能なタイムゾーンを簡単に確認し、ユーザーに適切なタイムゾーンを選択させることができます。

timezone_identifiers_list関数は、タイムゾーン識別子のリストを取得する際に便利ですが、引数の指定には注意が必要です。$timezoneGroupには、DateTimeZoneクラスの定数を使用することを推奨します。例えば、すべてのタイムゾーンを取得する場合はDateTimeZone::ALLを指定します。$countryCodeには、ISO 3166-1 alpha-2形式の国コードを指定します。大文字で記述する必要があることに注意してください。また、この関数は大量のデータを返す可能性があるため、メモリ使用量に注意し、必要なタイムゾーンのみを取得するように心がけましょう。

PHPでタイムゾーン識別子リストを取得する


1<?php
2
3/**
4 * タイムゾーン識別子のリストを取得するサンプルコード
5 */
6function getTimezoneIdentifiersListExample(): void
7{
8    // タイムゾーン識別子のリストを取得する
9    // デフォルトでは、すべてのタイムゾーングループが対象となる
10    $timezoneIdentifiers = timezone_identifiers_list();
11
12    // 結果を表示する
13    echo "すべてのタイムゾーン識別子:\n";
14    print_r($timezoneIdentifiers);
15
16    // 国コードを指定してタイムゾーン識別子を取得する例
17    $countryCode = 'JP'; // 日本
18    $timezoneIdentifiersForCountry = timezone_identifiers_list(null, $countryCode);
19
20    echo "\n日本 (JP) のタイムゾーン識別子:\n";
21    print_r($timezoneIdentifiersForCountry);
22
23    // 特定のタイムゾーングループ (例えば、地域) を指定する例
24    // DateTimeZone::ASIA (128) を使用
25    $timezoneIdentifiersForAsia = timezone_identifiers_list(DateTimeZone::ASIA);
26
27    echo "\nアジアのタイムゾーン識別子:\n";
28    print_r($timezoneIdentifiersForAsia);
29}
30
31// 関数の実行
32getTimezoneIdentifiersListExample();

このPHPサンプルコードは、timezone_identifiers_list()関数を使用して、タイムゾーン識別子のリストを取得する方法を示します。timezone_identifiers_list()関数は、タイムゾーンの情報を配列として返します。

引数には、オプションで $timezoneGroup と $countryCode を指定できます。$timezoneGroup は、取得するタイムゾーングループを絞り込むための整数値です。デフォルト値は 2047 で、これはすべてのグループを意味します。例えば、DateTimeZone::ASIA（値は128）を指定すると、アジアのタイムゾーンのみが取得できます。$countryCode は、ISO 3166-1 alpha-2形式の国コードで、特定の国のタイムゾーンを絞り込む際に使用します。例えば、'JP'（日本）を指定すると、日本のタイムゾーンのみが取得できます。

サンプルコードでは、まず引数なしでtimezone_identifiers_list()を呼び出し、すべてのタイムゾーン識別子を取得して表示します。次に、$countryCode に 'JP' を指定して、日本のタイムゾーン識別子を取得して表示します。最後に、$timezoneGroup に DateTimeZone::ASIA を指定して、アジアのタイムゾーン識別子を取得して表示します。

この関数を使用することで、システムで利用可能なタイムゾーンの一覧を動的に取得し、ユーザーに選択肢を提供したり、特定の地域や国に基づいた処理を行うことが可能になります。戻り値は文字列の配列であり、各要素はタイムゾーン識別子を表します。

timezone_identifiers_list()関数は、タイムゾーン識別子のリストを取得する際に便利ですが、引数の指定に注意が必要です。第1引数の$timezoneGroupは、DateTimeZoneクラスの定数で指定します。省略すると全てのグループが対象になります。第2引数の$countryCodeは、ISO 3166-1 alpha-2形式の国コードを指定します。存在しない国コードを指定すると空の配列が返ります。取得できるタイムゾーン識別子は、PHPが認識しているものに限られます。システムによっては、必要なタイムゾーンが登録されていない場合があるため、注意が必要です。また、大量のタイムゾーン識別子を取得するとメモリを消費する可能性があるため、必要な範囲に絞って取得することを推奨します。