萬盛學電腦網

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

PHP date() 日期時間格式化完整指南:常用格式字元、時區設定、時間戳轉換與實戰範例

date() 基本語法

string date ( string $format [, int $timestamp = time() ] )

第二參數為 Unix 時間戳 (預設當前時間)。

常用格式字元速查表

字元說明範例輸出
年
Y4 位數年份2024
y2 位數年份24
月
m數字月份,前導零01-12
n數字月份,無前導零1-12
F月份完整英文名January
M月份 3 字母縮寫Jan
日
d日期,前導零01-31
j日期,無前導零1-31
S日期序數後綴st, nd, rd, th
時間 (12小時制)
h小時,前導零01-12
g小時,無前導零1-12
aam/pm 小寫am
AAM/PM 大寫AM
時間 (24小時制)
H小時,前導零00-23
G小時,無前導零0-23
i分鐘,前導零00-59
s秒數,前導零00-59
星期
l星期完整名稱Monday
D星期 3 字母縮寫Mon
w星期數字 (0=星期日)0-6
W年份第幾週01-53
其他
t當月總天數28-31
z年份第幾天0-365
L是否閏年1/0
UUnix 時間戳1704067200
cISO 8601 格式2024-01-01T00:00:00+00:00
rRFC 2822 格式Mon, 01 Jan 2024 00:00:00 +0000

常用組合範例

<?php
// 日期
echo date('Y-m-d');       // 2024-01-15 (標準)
echo date('Y/n/j');       // 2024/1/15 (無前導零)
echo date('Y年m月d日');    // 2024年01月15日 (中文)
echo date('Y-F-jS');      // 2024-January-15th

// 時間
echo date('H:i:s');       // 14:30:59 (24小時制)
echo date('h:i:s A');     // 02:30:59 PM (12小時制)

// 完整日期時間
echo date('Y-m-d H:i:s'); // 2024-01-15 14:30:59 (資料庫常用)
echo date('c');           // ISO 8601 (API 傳輸標準)
echo date('r');           // RFC 2822 (HTTP 標頭、Email 標準)
?>

時區問題:核心痛點與解決方案

預設時區為 UTC,直接使用 date() 會與本地時間相差數小時 (台灣/中國 +8小時)。

方案一:腳本開頭設定 (最高優先級)

<?php
date_default_timezone_set('Asia/Taipei'); // 或 'Asia/Shanghai', 'PRC'
echo date('Y-m-d H:i:s'); // 正確顯示本地時間
?>

方案二:修改 php.ini (全域生效)

; php.ini
date.timezone = "Asia/Taipei"
; 可用值:Asia/Taipei, Asia/Shanghai, Asia/Hong_Kong, PRC, UTC 等

修改後重啟 PHP 服務。

方案三:DateTime 物件導向操作 (推薦現代寫法)

<?php
$tz = new DateTimeZone('Asia/Taipei');
$dt = new DateTime('now', $tz);
echo $dt->format('Y-m-d H:i:s');

// 或修改現有物件時區
$dt = new DateTime('2024-01-01 12:00:00', new DateTimeZone('UTC'));
$dt->setTimezone(new DateTimeZone('Asia/Taipei'));
echo $dt->format('Y-m-d H:i:s'); // 2024-01-01 20:00:00
?>

時間戳轉換

<?php
// 日期字串 → 時間戳
$ts = strtotime('2024-01-15 14:30:00');
$ts = strtotime('+1 week');
$ts = strtotime('next Monday');

// 時間戳 → 格式化日期
echo date('Y-m-d', $ts);

// DateTime 更強大
$dt = DateTime::createFromFormat('Y/m/d', '2024/01/15');
echo $dt->format('Y-m-d');
?>

進階:DateTime 類別 vs date() 函數

特性date()DateTime
風格程序式物件導向
時區處理全域設定物件級獨立時區
運算難 (需 strtotime)簡單 modify(), add(), sub(), diff()
不可變版本無DateTimeImmutable (PHP 5.5+)
格式化format 字串format 字串

結語

日期時間處理核心在於時區正確性。現代 PHP 專案強烈建議:統一使用 DateTime/DateTimeImmutable,配合 date_default_timezone_set('Asia/Taipei') 全域設定,徹底避開 date() 時區陷阱與 strtotime() 解析歧義。

copyright © 萬盛學電腦網 all rights reserved