計算時間差是業務開發高頻需求:會員天數、訂單超時、活動倒計時、日誌分析等。本文系統梳理 PHP 純計算、MySQL 函數、應用層與資料庫層分工的最佳實踐。
<?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";
?>
<?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
?>
-- 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 分鐘未付款
| 單位 | 關鍵字 | 說明 |
|---|---|---|
| 微秒 | MICROSECOND | MySQL 5.6.4+ |
| 秒 | SECOND | |
| 分 | MINUTE | |
| 時 | HOUR | |
| 日 | DAY | |
| 周 | WEEK | |
| 月 | MONTH | |
| 季 | QUARTER | |
| 年 | YEAR |
| 場景 | 建議層 | 理由 |
|---|---|---|
| 報表統計、大量資料篩選 | MySQL (SQL 層) | 利用索引、避免傳輸大量資料到 PHP、效能高 |
| 單筆業務邏輯、複雜格式化輸出 | PHP (應用層) | DateTime 物件操作靈活、易測試、支援時區轉換 |
| 跨時區應用 | PHP | DateTimeZone 完整支援 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 存儲、業務邏輯指定時區 |
時間差計算核心原則:
TIMESTAMPDIFF()DateTime::diff()掌握這兩套工具組合,能應對 99% 的時間差計算業務場景。