PHP date_default_timezone_get() 函数

语法

string date_default_timezone_get ( void )

参数说明

此函数没有任何参数。

返回值

• 返回当前默认时区标识符的 字符串
• 如果未设置时区，则返回 UTC（PHP 5.4.0+）
• 在旧版本 PHP 中可能返回空字符串或 FALSE

示例代码

示例 1：基本用法

<?php
// 获取当前默认时区
$timezone = date_default_timezone_get();
echo "当前默认时区: " . $timezone . "<br>";

// 显示当前时间
echo "当前时间: " . date('Y-m-d H:i:s') . "<br>";

// 列出支持的时区数量
$timezones = timezone_identifiers_list();
echo "PHP支持的时区总数: " . count($timezones) . "<br>";

// 检查是否支持当前时区
if (in_array($timezone, $timezones)) {
    echo "时区 '{$timezone}' 是有效的PHP时区";
} else {
    echo "警告: 时区 '{$timezone}' 不是有效的PHP时区";
}
?>

示例 2：检查并设置时区

<?php
// 获取当前默认时区
$currentTimezone = date_default_timezone_get();
echo "当前时区: " . $currentTimezone . "<br>";

// 如果时区不是我们想要的，设置它
$desiredTimezone = 'Asia/Shanghai';
if ($currentTimezone !== $desiredTimezone) {
    echo "时区不正确，正在设置...<br>";

    // 检查时区是否有效
    if (in_array($desiredTimezone, timezone_identifiers_list())) {
        date_default_timezone_set($desiredTimezone);
        echo "时区已设置为: " . date_default_timezone_get() . "<br>";
    } else {
        echo "错误: 时区 '{$desiredTimezone}' 无效<br>";
    }
} else {
    echo "时区已经是 {$desiredTimezone}<br>";
}

// 显示设置后的时间
echo "当前时间: " . date('Y-m-d H:i:s') . "<br>";
echo "时区偏移: " . date('P') . "<br>"; // +08:00
?>

示例 3：时区继承关系

<?php
// 展示时区的优先级和继承关系
echo "date_default_timezone_get(): " . date_default_timezone_get() . "<br>";

// 创建一个DateTime对象（不指定时区，使用默认时区）
$date = new DateTime();
echo "DateTime时区: " . $date->getTimezone()->getName() . "<br>";

// 修改默认时区并观察变化
date_default_timezone_set('America/New_York');
echo "新默认时区: " . date_default_timezone_get() . "<br>";

// 新创建的DateTime对象会使用新时区
$date2 = new DateTime();
echo "新DateTime时区: " . $date2->getTimezone()->getName() . "<br>";

// 旧的DateTime对象时区不变
echo "旧DateTime时区: " . $date->getTimezone()->getName() . "<br>";

// 使用date()函数也会受影响
echo "当前时间（新时区）: " . date('Y-m-d H:i:s');
?>

示例 4：时区配置检测

<?php
// 检测时区配置的多种方式
function detectTimezoneSource() {
    $sources = [];

    // 1. date_default_timezone_get() 函数
    $sources['date_default_timezone_get'] = date_default_timezone_get();

    // 2. php.ini 配置（如果可读）
    $iniTimezone = ini_get('date.timezone');
    $sources['ini_get'] = $iniTimezone ?: '未设置或不可读';

    // 3. 环境变量（如果设置了）
    $envTimezone = getenv('TZ');
    $sources['environment'] = $envTimezone ?: '未设置';

    // 4. DateTimeZone 默认
    $defaultTz = new DateTimeZone(date_default_timezone_get());
    $sources['DateTimeZone_name'] = $defaultTz->getName();
    $sources['DateTimeZone_offset'] = $defaultTz->getOffset(new DateTime()) / 3600 . '小时';

    return $sources;
}

echo "时区配置检测报告:<br><br>";
foreach (detectTimezoneSource() as $source => $value) {
    echo "{$source}: {$value}<br>";
}

echo "<br>所有支持的时区区域:<br>";
$regions = [];
foreach (timezone_identifiers_list() as $tz) {
    $parts = explode('/', $tz, 2);
    if (isset($parts[1])) {
        $regions[$parts[0]] = true;
    }
}
echo implode(', ', array_keys($regions));
?>

示例 5：时区转换工具

<?php
// 时区转换工具函数
function convertTimeBetweenTimezones($time, $fromTz, $toTz) {
    $date = new DateTime($time, new DateTimeZone($fromTz));
    $date->setTimezone(new DateTimeZone($toTz));
    return $date->format('Y-m-d H:i:s');
}

// 获取当前默认时区
$defaultTz = date_default_timezone_get();
echo "当前默认时区: {$defaultTz}<br>";

// 转换示例
$time = '2024-03-15 14:30:00';

$conversions = [
    [$defaultTz, 'UTC'],
    [$defaultTz, 'America/New_York'],
    [$defaultTz, 'Asia/Tokyo'],
    [$defaultTz, 'Europe/London'],
];

foreach ($conversions as $conversion) {
    list($from, $to) = $conversion;
    $converted = convertTimeBetweenTimezones($time, $from, $to);
    echo "{$from} -> {$to}: {$converted}<br>";
}

// 显示当前时间在不同时区
echo "<br>当前时间在不同时区:<br>";
$now = new DateTime();
$timezones = ['UTC', 'Asia/Shanghai', 'America/Los_Angeles', 'Europe/Paris'];

foreach ($timezones as $tz) {
    $now->setTimezone(new DateTimeZone($tz));
    echo "{$tz}: " . $now->format('Y-m-d H:i:s') . "<br>";
}
?>

时区设置优先级

注意事项

PHP版本差异

常见错误与解决方案

<?php
// 错误1：时区警告
error_reporting(E_ALL);
ini_set('display_errors', 1);

// 如果没有设置时区，可能会看到警告
// 解决：在脚本开头设置时区
if (!date_default_timezone_get()) {
    date_default_timezone_set('UTC');
}

echo "当前时区: " . date_default_timezone_get() . "<br>";

// 错误2：时区缩写已弃用
$oldTz = 'EST'; // 已弃用的时区缩写
echo "测试时区 '{$oldTz}': ";

try {
    // 在PHP 7+中，这可能会产生警告或异常
    date_default_timezone_set($oldTz);
    echo "设置成功<br>";
} catch (Exception $e) {
    echo "错误: " . $e->getMessage() . "<br>";
    echo "建议使用完整时区标识符，如 'America/New_YYork'<br>";
}

// 解决方案：使用完整的时区标识符
date_default_timezone_set('America/New_York');
echo "正确设置时区: " . date_default_timezone_get();

// 错误3：时区不匹配导致的时间差异
date_default_timezone_set('UTC');
$utcTime = date('Y-m-d H:i:s');
echo "<br>UTC时间: {$utcTime}<br>";

date_default_timezone_set('Asia/Shanghai');
$shanghaiTime = date('Y-m-d H:i:s');
echo "上海时间: {$shanghaiTime}<br>";

echo "时间差: " . (strtotime($shanghaiTime) - strtotime($utcTime)) / 3600 . "小时";
?>

最佳实践

<?php
// 应用程序时区管理示例
class TimezoneManager {
    private static $defaultTimezone = 'UTC';

    // 初始化应用程序时区
    public static function init() {
        // 1. 检查是否已设置
        $current = date_default_timezone_get();

        // 2. 如果未设置或不是UTC，则设置
        if ($current !== self::$defaultTimezone) {
            // 3. 验证时区有效性
            if (in_array(self::$defaultTimezone, timezone_identifiers_list())) {
                date_default_timezone_set(self::$defaultTimezone);
                return true;
            } else {
                throw new Exception("无效的时区: " . self::$defaultTimezone);
            }
        }
        return false;
    }

    // 为用户转换时间
    public static function toUserTimezone($datetime, $userTimezone = null) {
        $date = new DateTime($datetime, new DateTimeZone(self::$defaultTimezone));

        if ($userTimezone && in_array($userTimezone, timezone_identifiers_list())) {
            $date->setTimezone(new DateTimeZone($userTimezone));
        }

        return $date->format('Y-m-d H:i:s');
    }

    // 获取当前时区信息
    public static function getInfo() {
        $tz = new DateTimeZone(date_default_timezone_get());
        $now = new DateTime();

        return [
            'name' => $tz->getName(),
            'offset' => $tz->getOffset($now),
            'formatted_offset' => $now->format('P'),
            'is_dst' => $now->format('I'),
            'location' => timezone_location_get($tz),
        ];
    }
}

// 使用示例
try {
    TimezoneManager::init();
    echo "应用程序时区: " . date_default_timezone_get() . "<br>";

    $utcTime = '2024-03-15 10:30:00';
    $userTime = TimezoneManager::toUserTimezone($utcTime, 'Asia/Shanghai');
    echo "UTC时间: {$utcTime} -> 用户时间: {$userTime}<br>";

    $info = TimezoneManager::getInfo();
    echo "时区信息: " . print_r($info, true);
} catch (Exception $e) {
    echo "错误: " . $e->getMessage();
}
?>

相关函数