萬盛學電腦網

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

PHP date() 日期時間格式化完整指南:格式字元、時間戳、常用範例

date() 是 PHP 最常用的日期時間格式化函數,將 Unix 時間戳轉為可讀字串。本文完整列出格式字元對照表、時間戳操作、常見格式範例與時區處理。

基本語法

<?php
date(string $format, ?int $timestamp = null): string

// 參數
// $format: 格式字串(必填)
// $timestamp: Unix 時間戳(可選,預設 time() 當前時間)

// 回傳:格式化後的日期時間字串
?>

格式字元完整對照表

字元說明範例輸出
日
d月份中的第幾天,2 位數補零01 到 31
D星期幾,3 字母縮寫Mon 到 Sun
j月份中的第幾天,不補零1 到 31
l (小寫 L)星期幾,完整名稱Sunday 到 Saturday
NISO-8601 星期幾1 (週一) 到 7 (週日)
S序數後綴st, nd, rd, th
w星期幾(數字)0 (週日) 到 6 (週六)
z年份中的第幾天0 到 365
週
WISO-8601 年份週數例:42
月
F月份完整名稱January 到 December
m月份數字,2 位數補零01 到 12
M月份縮寫,3 字母Jan 到 Dec
n月份數字,不補零1 到 12
t該月總天數28 到 31
年
L是否閏年1 或 0
oISO-8601 年份編號例:2024
Y4 位數年份例:2024
y2 位數年份例:24
時間
aam/pm 小寫am 或 pm
AAM/PM 大寫AM 或 PM
BSwatch Internet Time000 到 999
g12 小時制,不補零1 到 12
G24 小時制,不補零0 到 23
h12 小時制,2 位數補零01 到 12
H24 小時制,2 位數補零00 到 23
i分鐘,2 位數補零00 到 59
s秒數,2 位數補零00 到 59
u微秒(PHP 5.2.2+)例:654321
時區
e時區識別名UTC, Asia/Taipei
I是否夏令時間1 或 0
O與格林威治時差(小時)+0800
P與格林威治時差(含冒號)+08:00
T時區縮寫CST, EST, PDT
Z時區偏移秒數-43200 到 50400
完整格式
cISO 8601 格式2024-01-15T14:30:00+08:00
rRFC 2822 格式Mon, 15 Jan 2024 14:30:00 +0800
UUnix 時間戳1705312200

常用格式範例

<?php
$now = time(); // 當前時間戳

echo date('Y/m/d', $now);       // 2024/01/15
echo date('Y-m-d', $now);       // 2024-01-15
echo date('Y.m.d', $now);       // 2024.01.15
echo date('Y年m月d日', $now);    // 2024年01月15日

echo date('Y/m/d H:i:s', $now); // 2024/01/15 14:30:00
echo date('Y-m-d H:i:s', $now); // 2024-01-15 14:30:00

echo date('l, F jS, Y', $now);  // Monday, January 15th, 2024
echo date('D, M j, Y g:i A', $now); // Mon, Jan 15, 2024 2:30 PM

echo date('c', $now);           // 2024-01-15T14:30:00+08:00 (ISO 8601)
echo date('r', $now);           // Mon, 15 Jan 2024 14:30:00 +0800 (RFC 2828)
?>

時間戳操作

mktime():建立指定日期時間戳

<?php
// mktime(時, 分, 秒, 月, 日, 年)
$tomorrow = mktime(0, 0, 0, date('m'), date('d') + 1, date('Y'));
echo "明天是 " . date('Y/m/d', $tomorrow);

// 指定日期
$birthday = mktime(0, 0, 0, 5, 20, 1990);
echo "生日:" . date('Y-m-d', $birthday);
?>

strtotime():字串解析為時間戳(極強大)

<?php
echo strtotime('now');           // 當前時間戳
echo strtotime('+1 day');        // 明天
echo strtotime('next Monday');   // 下週一
echo strtotime('last day of February 2024'); // 2024-02-29 (閏年)
echo strtotime('first day of this month');   // 本月 1 號
echo strtotime('-1 month');      // 一個月前
echo strtotime('2024-12-25 10:00:00');       // 指定日期時間
?>

DateTime 類別(現代物件導向介面,推薦)

<?php
// 建立
$dt = new DateTime();                    // 現在
$dt = new DateTime('2024-12-25');        // 指定日期
$dt = new DateTime('now', new DateTimeZone('Asia/Taipei')); // 指定時區

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

// 修改
$dt->modify('+1 week');
$dt->add(new DateInterval('P1M'));       // 加 1 月
$dt->sub(new DateInterval('P3D'));       // 減 3 天
$dt->setTime(12, 0, 0);                  // 設定時間

// 比較
$dt1 = new DateTime('2024-01-01');
$dt2 = new DateTime('2024-12-31');
$diff = $dt1->diff($dt2);
echo $diff->days; // 365

// 時區轉換
$dt->setTimezone(new DateTimeZone('UTC'));
echo $dt->format('Y-m-d H:i:s T');
?>

時區設定

<?php
// 設定預設時區(建議在 bootstrap/啟動檔案設定一次)
date_default_timezone_set('Asia/Taipei');

// 或在 php.ini
// date.timezone = Asia/Taipei

// 取得支援時區清單
print_r(DateTimeZone::listIdentifiers());
?>
⚠️ 常見坑: 未設定時區會發出 E_WARNING 並使用 UTC。date() 使用預設時區,DateTime 可各實例指定時區。跨時區系統統一儲存 UTC,顯示時轉換用戶時區。

常見格式常數(PHP 5.1+)

<?php
echo date(DATE_ATOM);    // 2024-01-15T14:30:00+08:00 (ISO 8601)
echo date(DATE_COOKIE);  // Monday, 15-Jan-2024 14:30:00 CST
echo date(DATE_ISO8601); // 2024-01-15T14:30:00+0800
echo date(DATE_RFC822);  // Mon, 15 Jan 24 14:30:00 +0800
echo date(DATE_RFC850);  // Monday, 15-Jan-24 14:30:00 CST
echo date(DATE_RFC1036); // Mon, 15 Jan 2024 14:30:00 +0800
echo date(DATE_RFC1123); // Mon, 15 Jan 2024 14:30:00 +0800
echo date(DATE_RFC2822); // Mon, 15 Jan 2024 14:30:00 +0800
echo date(DATE_RFC3339); // 2024-01-15T14:30:00+08:00
echo date(DATE_RSS);     // Mon, 15 Jan 2024 14:30:00 +0800
echo date(DATE_W3C);     // 2024-01-15T14:30:00+08:00
?>
copyright © 萬盛學電腦網 all rights reserved