萬盛學電腦網

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

PHP date() 函數輸出中文日期與時區設定完整指南

前言

PHP date() 只能輸出英文格式,需自行組合中文年月日時分秒。PHP 5.3+ 強制要求設定時區,否則拋出警告。本文提供中文日期格式化函數、時區設定三種方法、完整格式字元參考表與 IntlDateFormatter 現代化方案。

一、中文日期格式化函數

function chineseDate(string $format = 'Y年m月d日 H時i分s秒', ?int $timestamp = null): string {
    $timestamp ??= time();
    $replacements = [
        'Y' => date('Y', $timestamp), // 4位年
        'y' => date('y', $timestamp), // 2位年
        'm' => date('m', $timestamp), // 2位月
        'n' => date('n', $timestamp), // 無前導零月
        'd' => date('d', $timestamp), // 2位日
        'j' => date('j', $timestamp), // 無前導零日
        'H' => date('H', $timestamp), // 24小時制
        'G' => date('G', $timestamp), // 無前導零24小時
        'h' => date('h', $timestamp), // 12小時制
        'g' => date('g', $timestamp), // 無前導零12小時
        'i' => date('i', $timestamp), // 分鐘
        's' => date('s', $timestamp), // 秒
        'a' => date('a', $timestamp), // am/pm
        'A' => date('A', $timestamp), // AM/PM
        'w' => ['日','一','二','三','四','五','六'][(int)date('w', $timestamp)], // 星期
        'l' => ['星期日','星期一','星期二','星期三','星期四','星期五','星期六'][(int)date('w', $timestamp)],
    ];
    return strtr($format, $replacements);
}

// 使用
echo chineseDate(); // 2024年05月23日 14時30分45秒
echo chineseDate('Y年n月j日 l'); // 2024年5月23日 星期四

二、時區設定三種方法 (解決 date() 警告)

方法 1:程式碼設定 (推薦、可攜性最好)

方法 2:ini_set (執行期修改)

ini_set('date.timezone', 'Asia/Shanghai');

方法 3:php.ini 永久生效 (需重啟 PHP-FPM/Apache)

; php.ini
date.timezone = "Asia/Shanghai"
; 或
date.timezone = "PRC"

常用時區識別字串

Asia/Taipei      // 台灣 (CST, UTC+8, 無夏令時間)
Asia/Shanghai    // 中國大陸
Asia/Hong_Kong   // 香港
Asia/Singapore   // 新加坡
America/New_York // 美東 (EST/EDT, 有夏令時間)
Europe/London    // 英國 (GMT/BST, 有夏令時間)
UTC              // 世界協調時間

三、date() 格式字元完整參考表

字元說明範例
Y4位數年份2024
y2位數年份24
m月份 (01-12)05
n月份 (1-12)5
F月份完整英文名May
M月份縮寫 (3字母)May
d日期 (01-31)23
j日期 (1-31)23
D星期縮寫 (3字母)Thu
l星期完整英文名Thursday
w星期數字 (0=週日, 6=週六)4
NISO-8601 星期 (1=週一, 7=週日)4
z年間第幾天 (0-365)143
W年間第幾週 (ISO-8601, 週一開始)21
t該月總天數31
L是否閏年 (1/0)1
H24小時制 (00-23)14
G24小時制 (0-23)14
h12小時制 (01-12)02
g12小時制 (1-12)2
i分鐘 (00-59)30
s秒數 (00-59)45
u微秒 (PHP 5.2.2+)123456
e時區識別符Asia/Taipei
O與 GMT 時差 (小時)+0800
P與 GMT 時差 (時:分)+08:00
T本機時區縮寫CST
Z時差秒數 (負為西區)28800
cISO 8601 格式2024-05-23T14:30:45+08:00
rRFC 2822 格式Thu, 23 May 2024 14:30:45 +0800
UUnix 時間戳1716445845

四、進階:IntlDateFormatter (PHP 5.3+ intl 擴展)

支援多語系、地區化格式、相對時間、時區轉換,是現代專案的標準選擇。

format(time()); 
// 2024年5月23日 星期四 下午02時30分45秒 CST

// 自定義模式
$fmt->setPattern('yyyy年MM月dd日 HH時mm分ss秒');
echo $fmt->format(time()); 
// 2024年05月23日 14時30分45秒

// 相對時間格式化 (PHP 8.0+)
$rel = new IntlRelativeTimeFormatter('zh_TW');
echo $rel->format(-1, IntlRelativeTimeFormatter::DAY); // 昨天
echo $rel->format(3, IntlRelativeTimeFormatter::HOUR); // 3小時後

五、常見日期運算

// strtotime 相對時間
strtotime('+1 day');      // 明天這時
strtotime('next Monday'); // 下週一
strtotime('first day of this month'); // 本月1號
strtotime('last day of -1 month');    // 上月最後一天

// DateTime 物件導向 (推薦)
$dt = new DateTime('now', new DateTimeZone('Asia/Taipei'));
$dt->modify('+1 month');
echo $dt->format('Y-m-d H:i:s');

// 日期差
$dt1 = new DateTime('2024-01-01');
$dt2 = new DateTime('2024-12-31');
$diff = $dt1->diff($dt2);
echo $diff->days; // 365
echo $diff->format('%y年%m月%d天');

總結

中文日期格式化:簡單場景用 strtr 替換,複雜多語系用 IntlDateFormatter。時區設定:**專案入口統一 date_default_timezone_set()**,不要依賴 php.ini (容器化部署時環境變數 TZ 更佳)。棄用 date() 進行運算,改用 DateTime / DateTimeImmutable 物件導向 API,避免時區、夏令時間、閏秒等陷阱。

copyright © 萬盛學電腦網 all rights reserved