| 工具 | 類型 | 特點 | 推薦場景 |
|---|---|---|---|
time() / strtotime() | 過程式/函數 | 簡單、字串解析強大、返回 Unix 時間戳 | 快速原型、簡單計算、舊代碼維護 |
date() / gmdate() | 格式化函數 | 格式化字串豐富、時區處理需額外設定 | 輸出顯示、日誌記錄 |
DateTime / DateTimeImmutable | 物件導向 | 時區原生支援、鏈式操作、不可變、不可變 | 現代專案首選、複雜運算、國際化 |
<?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";
}
?>
<?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) { /* ... */ }
?>
<?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 模板 -->
{$vo.create_time|humanTimeAdvanced}
<!-- Laravel Blade -->
{{ \Carbon\Carbon::parse($vo->create_time)->diffForHumans() }}
<!-- 原生 PHP 模板 -->
= humanTimeAdvanced($vo['create_time']) ?>
date_default_timezone_set('Asia/Taipei') 或 php.ini date.timezone = Asia/TaipeiSET time_zone = '+08:00' 或應用層轉換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()、時區在邊界轉換。拋棄字串拼湊運算,擁抱物件導向日期運算。