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);
?>