PHP timezone_name_get()函数

timezone_name_get() 函数是 DateTimeZone 类的方法，用于返回时区对象的名称。这个方法返回时区标识符，通常用于显示或记录时区信息。

注意：这不是一个独立的函数，而是 DateTimeZone 对象的实例方法，需要通过 DateTimeZone 对象调用。

语法

DateTimeZone::getName() : string

参数说明

参数 描述
无参数

timezone_name_get() 是 DateTimeZone 类的实例方法，不接受任何参数。

返回值

返回时区标识符（字符串）。

示例

示例 1：基本用法

<?php
// 创建 DateTimeZone 对象
$timezone = new DateTimeZone('America/New_York');

// 获取时区名称
$timezone_name = $timezone->getName();

echo "时区名称: " . $timezone_name;
// 输出: 时区名称: America/New_York
?>

示例 2：多个时区的名称获取

<?php
// 获取多个时区的名称
$timezone_identifiers = [
    'America/New_York',
    'Asia/Shanghai',
    'Europe/London',
    'Australia/Sydney',
    'UTC',
    'GMT'
];

echo "<h4>时区名称列表:</h4>";
foreach ($timezone_identifiers as $identifier) {
    try {
        $timezone = new DateTimeZone($identifier);
        $name = $timezone->getName();
        echo $name . "<br>";
    } catch (Exception $e) {
        echo "错误: " . $e->getMessage() . "<br>";
    }
}

// 输出:
// America/New_York
// Asia/Shanghai
// Europe/London
// Australia/Sydney
// UTC
// GMT
?>

示例 3：与时区相关函数配合使用

<?php
// 创建 DateTimeZone 对象
$timezone = new DateTimeZone('Asia/Shanghai');

// 获取时区名称
$name = $timezone->getName();
echo "时区名称: " . $name . "<br>";

// 获取时区位置信息
$location = $timezone->getLocation();
if ($location !== false) {
    echo "位置信息: ";
    echo "国家代码: " . $location['country_code'] . ", ";
    echo "纬度: " . $location['latitude'] . ", ";
    echo "经度: " . $location['longitude'] . "<br>";
}

// 获取时区偏移量
$date = new DateTime('now', $timezone);
$offset = $timezone->getOffset($date);
echo "当前偏移量: " . $offset . " 秒 (" . ($offset / 3600) . " 小时)<br>";

// 获取时区转换
$transitions = $timezone->getTransitions(time(), time() + 365 * 24 * 60 * 60);
echo "未来一年的时区转换数: " . count($transitions) . "<br>";

// 输出类似:
// 时区名称: Asia/Shanghai
// 位置信息: 国家代码: CN, 纬度: 31.0456, 经度: 121.3997
// 当前偏移量: 28800 秒 (8 小时)
// 未来一年的时区转换数: 0
?>

示例 4：在 DateTime 对象中使用时区名称

<?php
// 创建带时区的 DateTime 对象
$timezone = new DateTimeZone('Europe/London');
$date = new DateTime('now', $timezone);

// 从 DateTime 对象获取时区名称
$timezone_from_date = $date->getTimezone();
$timezone_name = $timezone_from_date->getName();

echo "当前时间: " . $date->format('Y-m-d H:i:s') . "<br>";
echo "时区名称: " . $timezone_name . "<br>";
echo "时区缩写: " . $date->format('T') . "<br>";
echo "时区偏移: " . $date->format('P') . "<br>";

// 修改时区
$new_timezone = new DateTimeZone('Asia/Tokyo');
$date->setTimezone($new_timezone);

echo "<br>修改时区后:<br>";
echo "当前时间: " . $date->format('Y-m-d H:i:s') . "<br>";
echo "时区名称: " . $date->getTimezone()->getName() . "<br>";
echo "时区缩写: " . $date->format('T') . "<br>";
echo "时区偏移: " . $date->format('P') . "<br>";

// 输出类似:
// 当前时间: 2023-08-15 10:30:45
// 时区名称: Europe/London
// 时区缩写: BST
// 时区偏移: +01:00
//
// 修改时区后:
// 当前时间: 2023-08-15 18:30:45
// 时区名称: Asia/Tokyo
// 时区缩写: JST
// 时区偏移: +09:00
?>

示例 5：错误处理

<?php
// 错误处理示例
function getTimezoneName($timezone_identifier) {
    try {
        $timezone = new DateTimeZone($timezone_identifier);
        return $timezone->getName();
    } catch (Exception $e) {
        return "错误: " . $e->getMessage();
    }
}

// 测试各种情况
$test_cases = [
    'America/New_York',  // 有效时区
    'Asia/Shanghai',     // 有效时区
    'Invalid/Timezone',  // 无效时区
    'UTC',               // 有效时区
    'Not/A/Real/TZ',     // 无效时区
    'Europe/London'      // 有效时区
];

echo "<h4>时区名称获取测试:</h4>";
foreach ($test_cases as $identifier) {
    $result = getTimezoneName($identifier);
    echo $identifier . ": " . $result . "<br>";
}

// 输出类似:
// America/New_York: America/New_York
// Asia/Shanghai: Asia/Shanghai
// Invalid/Timezone: 错误: DateTimeZone::__construct(): Unknown or bad timezone (Invalid/Timezone)
// UTC: UTC
// Not/A/Real/TZ: 错误: DateTimeZone::__construct(): Unknown or bad timezone (Not/A/Real/TZ)
// Europe/London: Europe/London
?>

示例 6：比较时区名称

<?php
// 比较时区名称
function compareTimezones($timezone1, $timezone2) {
    try {
        $tz1 = new DateTimeZone($timezone1);
        $tz2 = new DateTimeZone($timezone2);

        $name1 = $tz1->getName();
        $name2 = $tz2->getName();

        if ($name1 === $name2) {
            return "时区相同: " . $name1;
        } else {
            return "时区不同: " . $name1 . " ≠ " . $name2;
        }
    } catch (Exception $e) {
        return "比较失败: " . $e->getMessage();
    }
}

// 测试比较
$comparisons = [
    ['America/New_York', 'America/New_York'],
    ['America/New_York', 'America/Chicago'],
    ['UTC', 'GMT'],
    ['Asia/Shanghai', 'Asia/Shanghai'],
    ['Europe/London', 'Europe/Paris']
];

echo "<h4>时区比较:</h4>";
foreach ($comparisons as $pair) {
    $result = compareTimezones($pair[0], $pair[1]);
    echo $pair[0] . " 与 " . $pair[1] . ": " . $result . "<br>";
}

// 输出:
// America/New_York 与 America/New_York: 时区相同: America/New_York
// America/New_York 与 America/Chicago: 时区不同: America/New_York ≠ America/Chicago
// UTC 与 GMT: 时区不同: UTC ≠ GMT
// Asia/Shanghai 与 Asia/Shanghai: 时区相同: Asia/Shanghai
// Europe/London 与 Europe/Paris: 时区不同: Europe/London ≠ Europe/Paris
?>

示例 7：自定义时区类

<?php
// 自定义时区类，扩展 DateTimeZone
class CustomDateTimeZone extends DateTimeZone {
    private $description;

    public function __construct($timezone, $description = '') {
        parent::__construct($timezone);
        $this->description = $description;
    }

    // 重写 getName 方法
    public function getName() {
        $name = parent::getName();
        if (!empty($this->description)) {
            $name .= ' (' . $this->description . ')';
        }
        return $name;
    }

    public function getFullInfo() {
        return [
            'identifier' => parent::getName(),
            'description' => $this->description,
            'formatted_name' => $this->getName(),
            'location' => $this->getLocation()
        ];
    }
}

// 使用自定义时区类
$custom_tz = new CustomDateTimeZone('America/New_York', '美国东部时间');

echo "时区名称: " . $custom_tz->getName() . "<br>";
echo "<pre>";
print_r($custom_tz->getFullInfo());
echo "</pre>";

// 创建另一个自定义时区
$shanghai_tz = new CustomDateTimeZone('Asia/Shanghai', '中国标准时间');
echo "上海时区: " . $shanghai_tz->getName() . "<br>";

// 输出类似:
// 时区名称: America/New_York (美国东部时间)
// Array
// (
//     [identifier] => America/New_York
//     [description] => 美国东部时间
//     [formatted_name] => America/New_York (美国东部时间)
//     [location] => Array
//         (
//             [country_code] => US
//             [latitude] => 40.7142
//             [longitude] => -74.0064
//             [comments] =>
//         )
// )
// 上海时区: Asia/Shanghai (中国标准时间)
?>

示例 8：序列化和反序列化时区对象

<?php
// 序列化和反序列化时区对象
$original_timezone = new DateTimeZone('America/New_York');
$original_name = $original_timezone->getName();

echo "原始时区名称: " . $original_name . "<br>";

// 序列化对象
$serialized = serialize($original_timezone);
echo "序列化数据: " . htmlspecialchars($serialized) . "<br>";

// 反序列化对象
$unserialized = unserialize($serialized);
$unserialized_name = $unserialized->getName();

echo "反序列化后时区名称: " . $unserialized_name . "<br>";

// 验证是否相同
if ($original_name === $unserialized_name) {
    echo "✓ 时区名称保持一致<br>";
} else {
    echo "✗ 时区名称不一致<br>";
}

// 测试序列化多个时区
$timezones = [
    'Asia/Shanghai',
    'Europe/London',
    'Australia/Sydney'
];

echo "<h4>多个时区序列化测试:</h4>";
foreach ($timezones as $identifier) {
    $tz = new DateTimeZone($identifier);
    $serialized = serialize($tz);
    $unserialized = unserialize($serialized);

    if ($tz->getName() === $unserialized->getName()) {
        echo "✓ " . $identifier . " 序列化/反序列化成功<br>";
    } else {
        echo "✗ " . $identifier . " 序列化/反序列化失败<br>";
    }
}

// 输出类似:
// 原始时区名称: America/New_York
// 序列化数据: O:12:"DateTimeZone":2:{s:13:"timezone_type";i:3;s:8:"timezone";s:16:"America/New_York";}
// 反序列化后时区名称: America/New_York
// ✓ 时区名称保持一致
//
// 多个时区序列化测试:
// ✓ Asia/Shanghai 序列化/反序列化成功
// ✓ Europe/London 序列化/反序列化成功
// ✓ Australia/Sydney 序列化/反序列化成功
?>

DateTimeZone 类的方法总结

方法 描述 返回类型
getName() 返回时区名称（标识符） string
getLocation() 返回时区的位置信息 array|false
getOffset(DateTime $datetime) 返回相对于 UTC 的偏移量（秒） int
getTransitions() 返回时区转换信息 array
listAbbreviations() 返回时区缩写列表（静态方法） array
listIdentifiers() 返回时区标识符列表（静态方法） array

常见时区标识符

时区标识符 描述 常见使用地区
America/New_York 美国东部时间 纽约、华盛顿、迈阿密
America/Chicago 美国中部时间 芝加哥、达拉斯、休斯顿
America/Denver 美国山地时间 丹佛、凤凰城、盐湖城
America/Los_Angeles 美国太平洋时间 洛杉矶、旧金山、西雅图
Europe/London 英国时间 伦敦、都柏林、爱丁堡
Europe/Paris 中欧时间 巴黎、柏林、罗马、马德里
Asia/Shanghai 中国标准时间 北京、上海、广州、深圳
Asia/Tokyo 日本标准时间 东京、大阪、名古屋
Australia/Sydney 澳大利亚东部时间 悉尼、墨尔本、布里斯班
UTC 协调世界时 全球标准
GMT 格林威治标准时间 与 UTC 相同

注意事项

  • timezone_name_get() 是 DateTimeZone 类的实例方法，不是独立函数
  • 时区名称是时区标识符，如 "America/New_York"，而不是缩写 "EST"
  • 不同的 DateTimeZone 对象可能有相同的名称
  • 时区名称是只读的，创建 DateTimeZone 对象后不能修改
  • 使用时区名称前应确保时区标识符有效
  • 考虑使用时区名称的国际化显示，特别是在多语言应用中

最佳实践

场景 建议
存储时区信息 使用时区标识符（如 "America/New_York"）而不是缩写（"EST"）
显示时区给用户 使用时区标识符，或转换为用户友好的名称
比较时区 比较时区名称（标识符）而不是对象引用
序列化时区 序列化 DateTimeZone 对象或存储时区名称
数据库存储 存储时区名称字符串，而不是整个对象
多语言应用 将时区名称映射到本地化显示名称

相关函数和类

上一章: timezone_name_from_abbr() 函数 下一章: timezone_offset_get() 函数