idate
(PHP 5, PHP 7, PHP 8)
idate — 將本地時間日期格式化為整數
說明
idate(string
$format, int $timestamp = ?): int 根據給定的格式字元對 timestamp 格式化並返回數字結果。timestamp 為可選項,預設值為本地當前時間,即 time() 的值。
和 date() 不同,idate() 只接受一個字元作為 format 參數。
format 字元 | 說明 |
|---|---|
B | Swatch Beat/Internet Time |
d | 月份中的第幾天 |
h | 小時(12 小時格式) |
H | 小時(24 小時格式) |
i | 分鐘 |
I | 如果啟用夏時制則返回 1,否則返回 0 |
L | 如果是閏年則返回 1,否則返回 0 |
m | 月份的數字 |
s | 秒數 |
t | 本月的總天數 |
U | 自 Unix 紀元(January 1 1970 00:00:00 GMT)起的秒數——這和 time() 作用相同 |
w | 星期中的第幾天(星期天是 0) |
W | ISO-8601 格式年份中的第幾個星期,每星期從星期一開始 |
y | 年份(1 或 2 位數字——見下面說明) |
Y | 年份(4 位數字) |
z | 年份中的第幾天 |
Z | 以秒為單位的時區偏移量 |
注意:
因為 idate() 總是返回 integer,不能以「0」開頭,因此 idate() 可能會返回比使用者期望中要少的數字。見下面例子:
<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// 下面以兩位數字格式顯示年份,但是因為
// 以「0」打頭,因此只會顯示「4」
echo idate('y', $timestamp);
?>