將 DateTime 物件轉為人類可讀的相對時間字串,支援自訂精度 (預設最大單位)。
<?php
/**
* 友好相對時間
* @param DateTime|int $datetime DateTime 物件或 Unix 時間戳
* @param int $size 顯示精度 (最多幾個單位),預設 1
* @return string 如 "2天前"、"1小時30分前"、"剛剛"
* @throws InvalidArgumentException
*/
function friendly_date($datetime, $size = 1) {
if (is_int($datetime)) {
$datetime = new DateTime('@' . $datetime);
}
if (!($datetime instanceof DateTime)) {
throw new InvalidArgumentException('需要 DateTime 物件或時間戳');
}
$now = new DateTime();
$interval = $now->diff($datetime); // DateInterval
$units = [
'y' => '年',
'm' => '個月',
'd' => '天',
'h' => '小時',
'i' => '分鐘',
's' => '秒',
];
$parts = [];
foreach ($units as $key => $label) {
$value = $interval->$key;
if ($value > 0) {
$parts[] = $value . $label;
}
}
if (empty($parts)) return '剛剛';
return implode('', array_slice($parts, 0, $size));
}
// 使用範例
echo friendly_date(new DateTime('-3 days 5 hours')); // "3天前"
echo friendly_date(new DateTime('-1 hour 30 min'), 2); // "1小時30分鐘前"
echo friendly_date(time() - 10); // "剛剛"
echo friendly_date(strtotime('2020-01-01')); // "4年..." (視當前時間)
DateTime::diff() 取得 DateInterval,自動處理閏年、月份天數差異。y, m, d, h, i, s,非零才加入結果,避免「0個月」干擾。$size 控制顯示幾個單位:1 只顯最大單位 (如「3天前」);2 顯示前兩個 (如「3天5小時前」)。$interval->invert。