萬盛學電腦網

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

PHP 時間戳與日期時間處理大全:strtotime、DateTime、相對格式、人性化輸出

PHP 日期時間三大核心工具

工具類型特點推薦場景
time() / strtotime()過程式/函數簡單、字串解析強大、返回 Unix 時間戳快速原型、簡單計算、舊代碼維護
date() / gmdate()格式化函數格式化字串豐富、時區處理需額外設定輸出顯示、日誌記錄
DateTime / DateTimeImmutable物件導向時區原生支援、鏈式操作、不可變、不可變現代專案首選、複雜運算、國際化

strtotime 相對日期格式完全指南

<?php
$base = '2024-01-15 14:30:00';

$formats = [
    'now' => '當前時間',
    '+1 day' => '明天同一時間',
    '-1 day' => '昨天同一時間',
    '+1 week' => '下週同一時間',
    '-1 week' => '上週同一時間',
    '+1 month' => '下月同一天(自動處理月末)',
    '-1 month' => '上月同一天',
    '+1 year' => '明年同一天',
    'first day of this month' => '本月 1 號 00:00:00',
    'last day of this month' => '本月最後一天 23:59:59',
    'first day of last month' => '上月 1 號',
    'last day of last month' => '上月最後一天',
    'first day of next month' => '下月 1 號',
    'last day of next month' => '下月最後一天',
    'next Monday' => '下一個週一',
    'last Friday' => '上一個週五',
    'this Thursday' => '本週四(若今天是週四則今天)',
    'tomorrow' => '明天 00:00:00',
    'yesterday' => '昨天 00:00:00',
    'noon' => '今天 12:00:00',
    'midnight' => '明天 00:00:00',
];

foreach ($formats as $format => $desc) {
    $ts = strtotime($format, strtotime($base));
    echo "$desc ($format): " . date('Y-m-d H:i:s', $ts) . "\n";
}
?>

DateTimeImmutable 現代最佳實踐

<?php
// 建立實例
$dt = new DateTimeImmutable('2024-01-15 14:30:00', new DateTimeZone('Asia/Taipei'));
$dt = DateTimeImmutable::createFromFormat('Y-m-d H:i:s', '2024-01-15 14:30:00', new DateTimeZone('UTC'));

// 不可變鏈式操作(每次修改返回新物件)
$startOfMonth = $dt->modify('first day of this month')->setTime(0, 0, 0);
$endOfMonth = $dt->modify('last day of this month')->setTime(23, 59, 59);
$lastMonthStart = $dt->modify('first day of last month')->setTime(0, 0, 0);
$nextMonthEnd = $dt->modify('last day of next month')->setTime(23, 59, 59);

// 格式化輸出
echo $startOfMonth->format('Y-m-d H:i:s'); // 2024-01-01 00:00:00
echo $startOfMonth->format('Y年m月d日 H:i:s'); // 2024年01月01日 14:30:00
echo $startOfMonth->format('c'); // ISO 8601: 2024-01-01T00:00:00+08:00
echo $startOfMonth->format('r'); // RFC 2822: Mon, 01 Jan 2024 00:00:00 +0800

// 時區轉換(不改變時間點,只改變表示)
$utc = $startOfMonth->setTimezone(new DateTimeZone('UTC'));
$tokyo = $startOfMonth->setTimezone(new DateTimeZone('Asia/Tokyo'));

// 差值計算
$diff = $endOfMonth->diff($startOfMonth);
echo $diff->format('%a 天 %h 小時 %i 分鐘'); // 30 天 23 小時 59 分鐘

// 比較
if ($dt1 > $dt2) { /* ... */ }
if ($dt1 == $dt2) { /* ... */ }
?>

人性化時間輸出(相對時間:剛剛、N 分鐘前、昨天...)

<?php
function humanTime(int $timestamp, string $lang = 'zh'): string
{
    $now = time();
    $diff = $now - $timestamp;
    
    if ($diff < 0) $diff = 0; // 未來時間
    
    $units = match ($lang) {
        'zh' => [
            'year' => ['年', 31536000],
            'month' => ['月', 2592000],
            'week' => ['週', 604800],
            'day' => ['天', 86400],
            'hour' => ['小時', 3600],
            'minute' => ['分鐘', 60],
            'second' => ['秒', 1],
        ],
        'en' => [
            'year' => ['year', 31536000],
            'month' => ['month', 2592000],
            'week' => ['week', 604800],
            'day' => ['day', 86400],
            'hour' => ['hour', 3600],
            'minute' => ['minute', 60],
            'second' => ['second', 1],
        ],
    };
    
    if ($diff < 60) return $lang === 'zh' ? '剛剛' : 'just now';
    
    foreach ($units as $unit => [$label, $seconds]) {
        if ($diff >= $seconds) {
            $value = (int)($diff / $seconds);
            if ($lang === 'zh') {
                return "{$value}{$label}前";
            }
            return $value === 1 ? "1 $label ago" : "{$value} {$label}s ago";
        }
    }
    
    return date('Y-m-d', $timestamp);
}

// 進階版:處理跨年、昨天/前天顯示時間、一年內不顯示年份
function humanTimeAdvanced(int $timestamp, string $lang = 'zh'): string
{
    $now = time();
    $diff = $now - $timestamp;
    $sameYear = date('Y', $now) === date('Y', $timestamp);
    
    if ($diff < 60) return $lang === 'zh' ? '剛剛' : 'just now';
    if ($diff < 3600) return ($lang === 'zh' ? floor($diff/60).'分鐘前' : floor($diff/60).' minutes ago');
    if ($diff < 86400) return ($lang === 'zh' ? floor($diff/3600).'小時前' : floor($diff/3600).' hours ago');
    
    // 昨天/前天特殊顯示
    $diffDays = (int)($diff / 86400);
    if ($diffDays === 1) {
        return ($lang === 'zh' ? '昨天 ' : 'yesterday at ') . date('H:i', $timestamp);
    }
    if ($diffDays === 2) {
        return ($lang === 'zh' ? '前天 ' : 'day before yesterday at ') . date('H:i', $timestamp);
    }
    if ($diffDays < 7) {
        return ($lang === 'zh' ? "{$diffDays}天前" : "{$diffDays} days ago");
    }
    if ($diffDays < 30) {
        return ($lang === 'zh' ? floor($diffDays/7).'週前' : floor($diffDays/7).' weeks ago');
    }
    if ($diffDays < 365 && $sameYear) {
        return date('m月d日 H:i', $timestamp);
    }
    
    return date($sameYear ? 'm月d日' : 'Y年m月d日', $timestamp);
}
?>

ThinkPHP / Laravel 模板中使用

<!-- ThinkPHP 模板 -->
{$vo.create_time|humanTimeAdvanced}

<!-- Laravel Blade -->
{{ \Carbon\Carbon::parse($vo->create_time)->diffForHumans() }}

<!-- 原生 PHP 模板 -->

常見時區陷阱與解決

  1. 預設時區未設定:date_default_timezone_set('Asia/Taipei') 或 php.ini date.timezone = Asia/Taipei
  2. 資料庫存 UTC,顯示轉用戶時區:SET time_zone = '+08:00' 或應用層轉換
  3. 夏令時間(DST):DateTime 自動處理,strtotime 需注意
  4. 跨年月份計算:modify('+1 month') 在 1/31 會變 3/3(因 2 月無 31 日),用 'first day of next month' 避免

效能微優化

  • 高頻呼叫:time() 比 DateTimeImmutable::createFromInterface() 快 10 倍
  • 格式化輸出:date() 比 DateTime::format() 快 2-3 倍
  • 大量日期運算:批次處理、預計算常用範圍

總結

現代 PHP 日期時間處理核心原則:內部統一用 UTC Unix 時間戳/DateTimeImmutable、輸入解析用 strtotime/DateTime::createFromFormat、運算用 modify()/diff()、輸出用 format()/diffForHumans()、時區在邊界轉換。拋棄字串拼湊運算,擁抱物件導向日期運算。

copyright © 萬盛學電腦網 all rights reserved