萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 獲取全球時區列表並生成下拉選單的標準方法

需求

用戶註冊、個人設置、定時任務配置等場景需讓用戶選擇時區。PHP 內建 DateTimeZone::listIdentifiers() 可獲取完整 IANA 時區標識符,配合友好顯示名稱生成下拉選單。

現代最佳實踐(PHP 8.1+)

<?php
/**
 * 獲取結構化時區列表(分組按洲/地區)
 * @return array ['地區' => ['時區標識符' => '友好名稱', ...], ...]
 */
function getTimezoneGroups(): array {
    $identifiers = DateTimeZone::listIdentifiers(DateTimeZone::ALL);
    $groups = [];

    foreach ($identifiers as $tzId) {
        // 解析地區:Asia/Shanghai -> Asia
        $region = explode('/', $tzId)[0];
        
        // 生成友好名稱:GMT+08:00 Asia/Shanghai
        $tz = new DateTimeZone($tzId);
        $offset = $tz->getOffset(new DateTime('now', $tz));
        $sign = $offset >= 0 ? '+' : '-';
        $hours = abs(intdiv($offset, 3600));
        $minutes = abs(intdiv($offset % 3600, 60));
        $label = sprintf('GMT%s%02d:%02d %s', $sign, $hours, $minutes, $tzId);

        $groups[$region][$tzId] = $label;
    }

    // 按地區排序
    ksort($groups);
    foreach ($groups as &$list) {
        ksort($list);
    }

    return $groups;
}

// 生成下拉選單 HTML
function renderTimezoneSelect(string $name, ?string $selected = null, string $placeholder = '請選擇時區'): string {
    $groups = getTimezoneGroups();
    $html = "";
    return $html;
}

// 使用
echo renderTimezoneSelect('timezone', 'Asia/Shanghai');

輸出示例(片段)

<select name="timezone" id="timezone">
  <option value="" disabled>請選擇時區</option>
  <optgroup label="Asia">
    <option value="Asia/Shanghai" selected>GMT+08:00 Asia/Shanghai</option>
    <option value="Asia/Tokyo">GMT+09:00 Asia/Tokyo</option>
    <option value="Asia/Dubai">GMT+04:00 Asia/Dubai</option>
    ...
  </optgroup>
  <optgroup label="Europe">
    <option value="Europe/London">GMT+00:00 Europe/London</option>
    <option value="Europe/Paris">GMT+01:00 Europe/Paris</option>
    ...
  </optgroup>
  ...
</select>

舊版兼容方案(PHP 5.3+)

若無法使用 DateTimeZone::listIdentifiers,可維護靜態映射表(如原文的巨大數組),但需手動維護夏令時變更,不推薦長期使用。

前端增強:自動檢測用戶時區

<script>
// 瀏覽器獲取 IANA 時區
const userTz = Intl.DateTimeFormat().resolvedOptions().timeZone; // 例:Asia/Shanghai
document.getElementById('timezone').value = userTz;
</script>

數據庫存儲建議

  • 字段類型:VARCHAR(64) 存儲 IANA 標識符(如 Asia/Shanghai)。
  • 不要存儲偏移量(如 +08:00),無法處理夏令時。
  • 查詢時:CONVERT_TZ(utc_time, '+00:00', user_timezone)(MySQL)或 AT TIME ZONE(PostgreSQL)。

總結

使用 DateTimeZone::listIdentifiers() 獲取權威 IANA 時區列表,按地區分組生成 <optgroup> 下拉選單,前端自動檢測預選,資料庫存儲標識符。這是處理全球時區的標準、可維護方案。

copyright © 萬盛學電腦網 all rights reserved