萬盛學電腦網

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

PHP 日期時間格式化工具函數:支援中文星期與多種輸入格式

通用格式化函數 formatDate()

<?php
/**
 * 格式化日期時間
 * @param string $format 輸出格式(支援 date() 所有格式字元,另支援 'w' 為中文星期)
 * @param string|int $datetime 日期字串或時間戳
 * @param bool $chineseWeek 是否將 'w' 替換為中文星期
 * @return string 格式化後的日期字串
 */
function formatDate($format, $datetime, $chineseWeek = false) {
    // 自動偵測:大於 3000 視為時間戳,否則嘗試 strtotime 解析
    $timestamp = ($datetime > 3000) ? $datetime : strtotime($datetime);
    
    if ($timestamp === false) {
        return 'Invalid Date';
    }
    
    if ($chineseWeek) {
        $weeks = ['日', '一', '二', '三', '四', '五', '六'];
        $weekChar = $weeks[(int)date('w', $timestamp)];
        $format = str_replace('w', $weekChar, $format);
    }
    
    return date($format, $timestamp);
}

// 測試範例
echo '字串輸入:' . formatDate('w', '2012-11-03 00:46:22', true) . ' ' . formatDate('Y-m-d', '2012-11-03 00:46:22') . PHP_EOL;
// 輸出:六 2012-11-03

echo '時間戳輸入:' . formatDate('w', '1388678400', true) . ' ' . formatDate('Y-m-d', '1388678400') . PHP_EOL;
// 輸出:五 2014-01-03
?>

常用格式字元速查表

字元說明範例
Y4 位數年份2024
m月份(補零)01-12
n月份(不補零)1-12
d日期(補零)01-31
j日期(不補零)1-31
H24 小時制(補零)00-23
i分鐘(補零)00-59
s秒數(補零)00-59
w星期數字(0=週日)0-6
l英文完整星期名Sunday
D英文縮寫星期Sun

進階擴充:相對時間(幾分鐘前、幾小時前)

<?php
function timeAgo($timestamp) {
    $diff = time() - $timestamp;
    
    if ($diff < 60) return '剛剛';
    if ($diff < 3600) return floor($diff / 60) . ' 分鐘前';
    if ($diff < 86400) return floor($diff / 3600) . ' 小時前';
    if ($diff < 604800) return floor($diff / 86400) . ' 天前';
    
    return date('Y-m-d', $timestamp); // 超過一週顯示完整日期
}

// 使用
echo timeAgo(strtotime('-30 minutes')); // 30 分鐘前
echo timeAgo(strtotime('-2 days'));     // 2 天前
?>

時區處理提醒

<?php
// 設定預設時區(放在程式最前端)
date_default_timezone_set('Asia/Taipei');

// 或在格式化時指定時區(PHP 5.2+)
$dt = new DateTime('@' . $timestamp, new DateTimeZone('Asia/Taipei'));
echo $dt->format('Y-m-d H:i:s');
?>

建議專案統一使用 UTC 儲存資料庫,顯示時再轉換使用者時區。

copyright © 萬盛學電腦網 all rights reserved