PHP 日期時間格式化最佳實踐：時區處理、多格式輸出與效能優化

PHP 日期時間格式化最佳實踐：時區處理、多格式輸出與效能優化

日期時間處理是 Web 開發高頻需求。本文提供一個生產級的日期格式化函數，涵蓋時區設置、多格式支援、星期顯示、時間戳轉換等核心功能，並分析常見坑點與優化方向。

生產級格式化函數

<?php
/**
 * 格式化日期時間
 *
 * @param int $format 格式代碼：1=中文完整 2=標準SQL 3=短日期
 * @param string|null $timeStr 時間字符串，支援 strtotime 解析的所有格式
 * @return string 格式化後的日期字符串
 */
function formatDateTime(int $format = 1, ?string $timeStr = null): string {
    // 1. 設置時區（全局生效，建議在 bootstrap 階段統一設置）
    date_default_timezone_set('PRC');  // 或 Asia/Shanghai

    // 2. 解析時間戳
    $timestamp = $timeStr ? strtotime($timeStr) : time();

    // 3. 獲取星期
    $weekdays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
    $weekday = $weekdays[(int)date('w', $timestamp)];

    // 4. 根據格式代碼輸出
    return match ($format) {
        1 => date('Y年m月d日 H:i:s', $timestamp) . " $weekday",  // 2024年01月15日 14:30:00 星期一
        2 => date('Y-m-d H:i:s', $timestamp) . " $weekday",       // 2024-01-15 14:30:00 星期一
        3 => date('y/m/d', $timestamp),                            // 24/01/15
        default => throw new InvalidArgumentException("不支援的格式代碼: $format"),
    };
}

關鍵改進點解析

現代化替代方案：DateTime 類 (推薦)

<?php
function formatDateTimeModern(int $format = 1, ?string $timeStr = null): string {
    $dt = $timeStr ? new DateTime($timeStr, new DateTimeZone('PRC')) 
                   : new DateTime('now', new DateTimeZone('PRC'));

    $weekdays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
    $weekday = $weekdays[(int)$dt->format('w')];

    return match ($format) {
        1 => $dt->format('Y年m月d日 H:i:s') . " $weekday",
        2 => $dt->format('Y-m-d H:i:s') . " $weekday",
        3 => $dt->format('y/m/d'),
        default => throw new InvalidArgumentException("不支援的格式: $format"),
    };
}

DateTime 類優勢

• ✅ 物件導向，鏈式調用，不可變模式 (PHP 5.5+ DateTimeImmutable)
• ✅ 內建時區處理，無需全局設置
• ✅ 支援微秒精度、日期運算、差值計算
• ✅ 更好的國際化支援 (IntlDateFormatter)
• ✅ 避免 2038 年問題 (64 位系統)

常用格式字符速查表

效能優化建議

1. 高頻調用：使用 DateTimeImmutable 避免物件創建開銷
2. 批量格式化：預編譯格式字符串，避免重複解析
3. 快取策略：相同時間戳+格式的結果可快取 (如 Redis)
4. 時區設置：在 php.ini 設置 date.timezone = PRC，避免運行時調用

國際化擴展

<?php
use IntlDateFormatter;
use Locale;

function formatDateTimeI18n(string $locale = 'zh_CN', ?string $timeStr = null): string {
    $dt = $timeStr ? new DateTime($timeStr) : new DateTime();
    $formatter = new IntlDateFormatter(
        $locale,
        IntlDateFormatter::FULL,
        IntlDateFormatter::SHORT,
        'Asia/Shanghai',
        IntlDateFormatter::GREGORIAN,
        'yyyy年MM月dd日 HH:mm:ss EEEE'
    );
    return $formatter->format($dt);
}
// 輸出：2024年1月15日 下午02:30:00 星期一

掌握日期時間格式化的正確姿勢，不僅能避免時區、格式字符等常見坑點，更能為系統提供穩定、高效、可國際化的時間顯示服務。