Symfony 3表单TimezoneType定制：精简列表并显示UTC标识

我之前也碰到过一模一样的需求，默认的TimezoneType把所有城市都列出来，用户选起来太费劲了。下面是我实际落地过的两种方案，都能实现类似Twitter的简洁展示效果：

方案一：直接在表单类中自定义精简列表 #

这种方式最快，适合快速完成需求：

1. 先写个私有方法生成带UTC标识的选项：

private function getSimplifiedTimezones()
{
    // 先定义你需要的核心城市时区标识符
    $coreTimezones = [
        'Europe/London',
        'Europe/Paris',
        'Europe/Berlin',
        'Europe/Moscow',
        'Asia/Shanghai',
        'Asia/Tokyo',
        'Asia/Kolkata',
        'Australia/Sydney',
        'America/New_York',
        'America/Los_Angeles',
        'America/Chicago',
        'Africa/Cairo',
        // 可以根据你的用户群体补充更多时区
    ];

    $timezoneOptions = [];
    $currentDate = new \DateTime();

    foreach ($coreTimezones as $tzId) {
        $timezone = new \DateTimeZone($tzId);
        $offsetSeconds = $timezone->getOffset($currentDate);
        
        // 把秒数转换成友好的UTC偏移格式
        if ($offsetSeconds === 0) {
            $utcLabel = '(UTC)';
        } else {
            $sign = $offsetSeconds > 0 ? '+' : '-';
            $hours = abs(intval($offsetSeconds / 3600));
            $minutes = abs(intval(($offsetSeconds % 3600) / 60));
            $utcLabel = sprintf('(UTC%s%02d:%02d)', $sign, $hours, $minutes);
        }

        // 获取时区对应的城市名称
        $location = $timezone->getLocation();
        $cityName = $location['city'];
        
        // 组合成最终显示文本
        $timezoneOptions[$tzId] = sprintf('%s %s', $utcLabel, $cityName);
    }

    // 按UTC偏移量排序，让列表更直观
    uasort($timezoneOptions, function($a, $b) {
        preg_match('/UTC([+-]?\d+:\d+)/', $a, $matchA);
        preg_match('/UTC([+-]?\d+:\d+)/', $b, $matchB);
        $offsetA = $matchA[1] ?? '00:00';
        $offsetB = $matchB[1] ?? '00:00';
        return strcmp($offsetA, $offsetB);
    });

    return $timezoneOptions;
}

2. 然后在表单构建器里替换原来的TimezoneType为ChoiceType，传入自定义选项：

$builder->add('timezone', ChoiceType::class, [
    'choices' => $this->getSimplifiedTimezones(),
    'label' => '时区',
    'placeholder' => '请选择您的时区',
    'required' => true,
]);

方案二：封装成可复用服务（适合多表单场景） #

如果你的多个表单都需要这个精简时区列表，把逻辑封装成服务更优雅：

1. 创建一个时区助手类：

// src/AppBundle/Helper/TimezoneHelper.php
namespace AppBundle\Helper;

class TimezoneHelper
{
    public function getSimplifiedTimezones()
    {
        // 这里直接复用方案一中的生成逻辑即可
        $coreTimezones = [/*...*/];
        // ... 剩余代码和方案一完全一致
    }
}

2. 在app/config/services.yml中注册服务：

services:
    app.timezone_helper:
        class: AppBundle\Helper\TimezoneHelper

3. 在表单类中注入服务并使用：

// src/AppBundle/Form/YourFormType.php
namespace AppBundle\Form;

use AppBundle\Helper\TimezoneHelper;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\Form\Extension\Core\Type\ChoiceType;

class YourFormType extends AbstractType
{
    private $timezoneHelper;

    public function __construct(TimezoneHelper $timezoneHelper)
    {
        $this->timezoneHelper = $timezoneHelper;
    }

    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder->add('timezone', ChoiceType::class, [
            'choices' => $this->timezoneHelper->getSimplifiedTimezones(),
            // 其他配置项...
        ]);
    }
}

小提示 #

• 夏令时适配：代码里用当前时间计算偏移量，会自动适配夏令时（比如伦敦夏季会显示(UTC+01:00) London），如果想固定显示标准时间偏移，可以把$currentDate改成new \DateTime('2024-01-01')这样的非夏令时日期。
• 扩展列表：可以根据你的用户分布补充更多时区，比如东南亚、南美等地区的核心城市。

内容的提问来源于stack exchange，提问作者Jean-Baptiste Mace