萬盛學電腦網

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

PHP DateTime 轉友好相對時間 (如「3天前」、「剛剛」) 實用函數

將 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小時前」)。
  • 支援傳入 Unix 時間戳 (int) 自動轉換。
  • 未來時間會顯示為正數 (如「3天後」),若需區分可加判斷 $interval->invert。

擴充建議

  • 加入「剛剛」閾值 (如 < 30 秒)。
  • 支援多語系標籤陣列。
  • 整合到框架 Helper / Blade 指令 / Twig Filter 中複用。
copyright © 萬盛學電腦網 all rights reserved