萬盛學電腦網

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

PHP date() 日期時間格式化完整參考與實用範例

date() 是 PHP 格式化日期時間最常用的函數。本文提供完整格式字元參考表、常用組合範例、時區處理、以及現代 DateTime 物件導向用法。

基本語法

date(string $format, ?int $timestamp = null): string
  • $format:格式字串
  • $timestamp:Unix 時間戳,預設為 time()(當前時間)

完整格式字元對照表

字元說明範例輸出
年份
Y4 位數年份2024
y2 位數年份24
月份
m數字月份,前導零01 - 12
n數字月份,無前導零1 - 12
F英文完整月份名January
M英文縮寫月份Jan
日期
d月份中的第幾天,前導零01 - 31
j月份中的第幾天,無前導零1 - 31
z年份中的第幾天0 - 365
星期
l星期完整名稱Sunday
D星期縮寫Sun
w星期數字0 (Sun) - 6 (Sat)
NISO-8601 星期數字1 (Mon) - 7 (Sun)
時間 (24小時制)
H時,前導零00 - 23
G時,無前導零0 - 23
時間 (12小時制)
h時,前導零01 - 12
g時,無前導零1 - 12
aam/pm 小寫am / pm
AAM/PM 大寫AM / PM
分秒
i分,前導零00 - 59
s秒,前導零00 - 59
u微秒 (PHP 5.2.2+)654321
時區
e時區識別碼UTC, Asia/Taipei
O與 GMT 時差+0800
P與 GMT 時差 (含冒號)+08:00
T時區縮寫CST
完整格式
cISO 86012024-01-15T14:30:00+08:00
rRFC 2822Mon, 15 Jan 2024 14:30:00 +0800
UUnix 時間戳1705309800

常用組合範例

<?php
// 當前時間
echo date('Y-m-d H:i:s');        // 2024-01-15 14:30:00
echo date('Y/m/d');              // 2024/01/15
echo date('Y年m月d日');           // 2024年01月15日

// 含星期
echo date('Y-m-d (D)');          // 2024-01-15 (Mon)
echo date('Y-m-d l');            // 2024-01-15 Monday

// 12小時制
echo date('Y-m-d h:i:s A');      // 2024-01-15 02:30:00 PM

// ISO 8601 / RFC 3339 (API、資料交換標準)
echo date('c');                  // 2024-01-15T14:30:00+08:00
echo date(DateTime::RFC3339);    // 同上

// 自訂格式
echo date('m-d H:i');            // 01-15 14:30
echo date('dmY');                // 15012024

時區處理(關鍵)

<?php
// 方法一:php.ini 設定(全域)
date.timezone = "Asia/Taipei"

// 方法二:程式碼設定(每支腳本開頭)
date_default_timezone_set('Asia/Taipei');

// 方法三:DateTime 物件指定時區
$dt = new DateTime('now', new DateTimeZone('Asia/Taipei'));
echo $dt->format('Y-m-d H:i:s');

常見時區識別碼: Asia/Taipei、Asia/Shanghai、Asia/Hong_Kong、UTC、America/New_York

現代寫法:DateTime 類別(PHP 5.2+)

DateTime 提供物件導向介面、不可變體 DateTimeImmutable、支援運算、比較、差值計算,功能更強大。

<?php
// 建立
$now = new DateTime();                    // 當前時間,預設時區
$dt  = new DateTime('2024-01-15 14:30:00', new DateTimeZone('Asia/Taipei'));
$dt2 = DateTime::createFromFormat('Y-m-d', '2024-01-15');

// 格式化
echo $dt->format('Y-m-d H:i:s');

// 日期運算
$dt->modify('+1 day');           // 修改原物件
$dt->add(new DateInterval('P1M')); // 加 1 月
$dt->sub(new DateInterval('P7D')); // 減 7 天

// 不可變體 (PHP 5.5+) - 推薦用於避免副作用
$immutable = new DateTimeImmutable('2024-01-15');
$nextWeek = $immutable->add(new DateInterval('P1W')); // 回傳新物件,原物件不變

// 差值計算
$start = new DateTime('2024-01-01');
$end   = new DateTime('2024-01-15');
$diff  = $start->diff($end);
echo $diff->days;        // 14
echo $diff->format('%a 天 %h 小時 %i 分鐘');

// 比較
$dt1 = new DateTime('2024-01-15');
$dt2 = new DateTime('2024-01-20');
var_dump($dt1 < $dt2); // true

// 時間戳互轉
$timestamp = $dt->getTimestamp(); // 取得 Unix timestamp
$dt = (new DateTime())->setTimestamp($timestamp); // 從 timestamp 建立

常見陷阱與注意事項

問題原因解決
時間差 8 小時未設定時區,預設 UTCdate_default_timezone_set('Asia/Taipei')
月份 02-30 不報錯date() 不驗證日期有效性用 DateTime::createFromFormat() 驗證
strtotime() 解析歧義'01/02/2024' 美式/歐式格式衝突用 DateTime::createFromFormat() 指定格式
微秒一直是 000000date() 不支援微秒用 DateTime::format('u') 或 microtime(true)
32 位元系統 2038 年問題Unix timestamp 溢位用 64 位元 PHP + DateTime

實用工具函數

<?php
// 友善相對時間:剛剛、5分鐘前、3小時前、昨天、3天前、2024-01-15
function timeAgo(DateTimeInterface $time): string {
    $now = new DateTime();
    $diff = $now->getTimestamp() - $time->getTimestamp();
    
    if ($diff < 60) return '剛剛';
    if ($diff < 3600) return floor($diff/60) . ' 分鐘前';
    if ($diff < 86400) return floor($diff/3600) . ' 小時前';
    if ($diff < 172800) return '昨天';
    if ($diff < 604800) return floor($diff/86400) . ' 天前';
    return $time->format('Y-m-d');
}

// 取得本月第一天/最後一天
function getMonthRange(int $year, int $month): array {
    $first = new DateTime("{$year}-{$month}-01");
    $last = clone $first;
    $last->modify('last day of this month');
    return [$first, $last];
}

掌握 date() 格式字元與 DateTime 物件,能靈活處理各種日期時間需求。

copyright © 萬盛學電腦網 all rights reserved