WordPress 提供多種時間輸出函數,適用情境各異,以下整理最常用的五個函數與參數對照。
| 函數 | 用途 | 是否需在 Loop 內 | 回傳/輸出 |
|---|---|---|---|
the_date_xml() | 輸出 ISO 8601 格式 (YYYY-MM-DD),供 RSS/Atom 使用 | 是 | 直接輸出 |
the_date() | 顯示文章日期,同一天多篇文章僅第一篇顯示 | 是 | 直接輸出或回傳字串 |
the_time() | 顯示文章時間,每篇皆顯示,最常用 | 是 | 直接輸出 |
get_the_time() | 取得時間字串供 PHP 變數使用,不直接輸出 | 是 | 回傳字串 |
single_month_title() | 月份存檔頁標題,格式:前綴 + 月份 + 前綴 + 年份 | 否 | 直接輸出 |
| 參數 | 說明 | 範例輸出 |
|---|---|---|
Y | 4 位數年份 | 2024 |
y | 2 位數年份 | 24 |
m | 數字月份(補零) | 01~12 |
n | 數字月份(不補零) | 1~12 |
F | 完整月份名稱 | January |
M | 縮寫月份名稱 | Jan |
d | 日期(補零) | 01~31 |
j | 日期(不補零) | 1~31 |
l (小寫 L) | 完整星期名稱 | Monday |
D | 縮寫星期名稱 | Mon |
H | 24 小時制(補零) | 00~23 |
G | 24 小時制(不補零) | 0~23 |
h | 12 小時制(補零) | 01~12 |
g | 12 小時制(不補零) | 1~12 |
i | 分鐘(補零) | 00~59 |
s | 秒數(補零) | 00~59 |
a | am/pm 小寫 | am |
A | AM/PM 大寫 | PM |
S | 日期序數後綴 | st, nd, rd, th |
<?php the_time('Y年m月d日,H時i分'); ?>
<?php the_time('l, F j, Y \a\t g:i A'); ?>
<?php
$postTime = get_the_time('U'); // Unix Timestamp
if (time() - $postTime < 86400) {
echo '最新文章標記';
}
?>
若需每篇文章都顯示日期,請改用 the_time('Y-m-d') 而非 the_date()。
WordPress 核心使用 PHP `date()` 函數,輸出為英文。若需中文「星期一」等,需搭配語系檔或自行對應:
$weekMap = ['Sun'=>'日','Mon'=>'一','Tue'=>'二','Wed'=>'三','Thu'=>'四','Fri'=>'五','Sat'=>'六'];
echo '星期' . $weekMap[get_the_time('D')];