萬盛學電腦網

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

PHP 與 MySQL 計算時間差完整指南:天數、時分秒、業務邏輯與 SQL 方案對比

前言

計算時間差是業務開發高頻需求:會員天數、訂單超時、活動倒計時、日誌分析等。本文系統梳理 PHP 純計算、MySQL 函數、應用層與資料庫層分工的最佳實踐。

PHP 純計算方案

核心函數:strtotime() + 秒數運算

<?php
/**
 * 計算兩個日期之間的天數差
 * @param string|DateTime $start 開始日期 (支援 'YYYY-MM-DD', 'YYYY-MM-DD HH:II:SS', DateTime 物件)
 * @param string|DateTime $end 結束日期
 * @return int 天數差 (end - start,可為負)
 */
function diffDays($start, $end): int
{
    $startTs = $start instanceof DateTime ? $start->getTimestamp() : strtotime($start);
    $endTs = $end instanceof DateTime ? $end->getTimestamp() : strtotime($end);
    
    // 以天為單位取整 (向下取整)
    return (int)floor(($endTs - $startTs) / 86400);
}

/**
 * 計算精確時間差 (年/月/日/時/分/秒)
 * 使用 DateTime::diff (PHP 5.3+)
 */
function diffHuman($start, $end): DateInterval
{
    $startDt = $start instanceof DateTime ? $start : new DateTime($start);
    $endDt = $end instanceof DateTime ? $end : new DateTime($end);
    return $startDt->diff($endDt);
}

// 使用範例
$start = '1998-05-03';
$end = '1999-06-05';

echo "天數差: " . diffDays($start, $end) . " 天\n"; // 398 天

$interval = diffHuman($start, $end);
echo "精確差值: {$interval->y}年 {$interval->m}月 {$interval->d}天 {$interval->h}時 {$interval->i}分 {$interval->s}秒\n";
// 輸出: 精確差值: 1年 1月 2天 0時 0分 0秒

// 戀愛天數計算器
$loveStart = '2020-02-14';
$today = date('Y-m-d');
echo "戀愛天數: " . diffDays($loveStart, $today) . " 天\n";
?>

DateTime 類現代用法 (PHP 5.3+ 推薦)

<?php
$dt1 = new DateTime('1998-05-03');
$dt2 = new DateTime('1999-06-05');
$diff = $dt1->diff($dt2);

// 格式化輸出
echo $diff->format('%a 天總數');           // 總天數 (398)
echo $diff->format('%y 年 %m 月 %d 天');   // 1 年 1 月 2 天
echo $diff->format('%h 小時 %i 分鐘 %s 秒'); // 0 小時 0 分鐘 0 秒

// 判斷方向
echo $diff->invert ? '開始時間較晚' : '開始時間較早'; // invert=1 表示 start > end
?>

MySQL 計算方案

核心函數:DATEDIFF()、TIMESTAMPDIFF()、TIMEDIFF()

-- 1. 日期差 (天數)
SELECT DATEDIFF('1999-06-05', '1998-05-03'); -- 398

-- 2. 精確時間差 (指定單位) - 推薦
SELECT TIMESTAMPDIFF(DAY, '1998-05-03', '1999-06-05');     -- 398 天
SELECT TIMESTAMPDIFF(HOUR, '1998-05-03', '1999-06-05');    -- 9552 小時
SELECT TIMESTAMPDIFF(MINUTE, '1998-05-03', '1999-06-05');  -- 573120 分鐘
SELECT TIMESTAMPDIFF(SECOND, '1998-05-03', '1999-06-05');  -- 34387200 秒

-- 3. 時間差 (時間類型專用,返回 TIME 類型)
SELECT TIMEDIFF('1999-06-05 12:00:00', '1998-05-03 10:00:00'); -- 9552:00:00

-- 4. 日期加減運算
SELECT DATE_ADD('1998-05-03', INTERVAL 398 DAY);  -- 1999-06-05
SELECT DATE_SUB('1999-06-05', INTERVAL 1 YEAR);   -- 1998-06-05

-- 5. 實戰:訂單超時未付款查詢
SELECT * FROM orders 
WHERE status = 'pending' 
  AND TIMESTAMPDIFF(MINUTE, created_at, NOW()) > 30; -- 建立超過 30 分鐘未付款

MySQL 日期時間單位完整表

單位關鍵字說明
微秒MICROSECONDMySQL 5.6.4+
秒SECOND
分MINUTE
時HOUR
日DAY
周WEEK
月MONTH
季QUARTER
年YEAR

PHP 與 MySQL 分工最佳實踐

場景建議層理由
報表統計、大量資料篩選MySQL (SQL 層)利用索引、避免傳輸大量資料到 PHP、效能高
單筆業務邏輯、複雜格式化輸出PHP (應用層)DateTime 物件操作靈活、易測試、支援時區轉換
跨時區應用PHPDateTimeZone 完整支援 IANA 時區資料庫
資料庫遷移/異構同步PHP統一在應用層計算,避免 SQL 方言差異

實戰案例:會員等級依註冊天數判定

<?php
// PHP 版:靈活、可測試
function getMemberLevel(DateTime $registerDate): string
{
    $days = $registerDate->diff(new DateTime())->days;
    
    return match (true) {
        $days >= 365 * 3 => '鑽石會員',
        $days >= 365 * 2 => '白金會員',
        $days >= 365 => '黃金會員',
        $days >= 180 => '白銀會員',
        $days >= 30 => '青銅會員',
        default => '普通會員',
    };
}

// MySQL 版:批量更新會員等級 (定時任務)
/*
UPDATE members m
JOIN (
    SELECT id,
        CASE
            WHEN DATEDIFF(NOW(), register_date) >= 1095 THEN '鑽石會員'
            WHEN DATEDIFF(NOW(), register_date) >= 730 THEN '白金會員'
            WHEN DATEDIFF(NOW(), register_date) >= 365 THEN '黃金會員'
            WHEN DATEDIFF(NOW(), register_date) >= 180 THEN '白銀會員'
            WHEN DATEDIFF(NOW(), register_date) >= 30 THEN '青銅會員'
            ELSE '普通會員'
        END AS new_level
    FROM members
) tmp ON m.id = tmp.id
SET m.level = tmp.new_level
WHERE m.level != tmp.new_level;
*/
?>

時區陷阱與解決

<?php
// 1. PHP 預設時區 (php.ini 或運行時設定)
date_default_timezone_set('Asia/Taipei'); // 或 UTC

// 2. MySQL 時區設定
// 連線時設定: SET time_zone = '+08:00';
// 或 php.ini: pdo_mysql.default_timezone = '+08:00'

// 3. 最佳實踐:資料庫存 UTC,應用層轉換顯示
$utcDate = new DateTime('now', new DateTimeZone('UTC'));
// 存入 DB: $utcDate->format('Y-m-d H:i:s')

// 讀出時轉換用戶時區
$userTz = new DateTimeZone('America/New_York');
$localDate = clone $utcDate;
$localDate->setTimezone($userTz);
echo $localDate->format('Y-m-d H:i:s T'); // 2024-01-15 08:30:00 EST
?>

常見錯誤避坑

錯誤後果修正
用 mktime() 組合時間後相減跨 DST (夏令時間) 日期計算錯誤使用 DateTime::diff() 自動處理 DST
直接減時間戳除以 86400閏秒、DST 導致非整數天數用 floor() 或 DateInterval::days
MySQL 用 DATEDIFF 計算月份差只能算天數用 TIMESTAMPDIFF(MONTH, ...)
忽略時區導致跨日錯誤凌晨時段日期判斷錯誤統一用 UTC 存儲、業務邏輯指定時區

總結

時間差計算核心原則:

  1. 資料庫層:大量資料篩選、統計報表 → 使用 TIMESTAMPDIFF()
  2. 應用層:單筆業務邏輯、複雜格式化、跨時區 → 使用 DateTime::diff()
  3. 存儲統一 UTC:資料庫儲存 UTC 時間戳,顯示時轉換用戶時區
  4. 避免手動秒數運算:除非極簡單場景,否則易踩 DST/閏年/閏秒坑

掌握這兩套工具組合,能應對 99% 的時間差計算業務場景。

copyright © 萬盛學電腦網 all rights reserved