idate

(PHP 5、PHP 7、PHP 8)

idate将本地时间/日期部分格式化为整数

说明

idate(string $format, ?int $timestamp = null): int|false

使用给定的格式字符串和给定的整数 timestamp,或如果未给出时间戳,则使用当前本地时间,返回一个格式化的数字。换句话说,timestamp 是可选的,默认值为 time() 的值。

与函数 date() 不同,idate() 只接受 format 参数中的一个字符。

参数

format

format 参数字符串中识别以下字符
format 字符 说明
B Swatch Beat/互联网时间
d 月份中的日期
h 小时(12 小时格式)
H 小时(24 小时格式)
i 分钟
I(大写 i) 如果 DST 处于激活状态,则返回 1,否则返回 0
L(大写 l) 闰年返回 1,否则返回 0
m 月份编号
N ISO-8601 星期几(周一为 1,周日为 7
o ISO-8601 年份(4 位数字)
s
t 当前月份的天数
U 自 Unix 纪元(1970 年 1 月 1 日 00:00:00 UTC)以来的秒数 - 这与 time() 相同
w 星期几(周日为 0
W ISO-8601 年份的星期数,从周一开始
y 年份(1 或 2 位数字 - 请参阅下面的说明)
Y 年份(4 位数字)
z 一年中的日期
Z 时区偏移量(以秒为单位)

timestamp

可选的 timestamp 参数是一个 int Unix 时间戳,如果省略 timestamp 或为 null,则默认为当前本地时间。换句话说,它默认为 time() 的值。

返回值

成功时返回 int,失败时返回 false

由于 idate() 始终返回一个 int,并且它们不能以“0”开头,因此 idate() 返回的数字可能比您预期的少。请参见下面的示例。

错误/异常

如果时区无效,则每次调用日期/时间函数都会生成 E_WARNING。另请参见 date_default_timezone_set()

变更日志

版本 说明
8.2.0 添加了 N(ISO-8601 星期几)和 o(ISO-8601 年份)格式字符。
8.0.0 timestamp 现在可以为空。

示例

示例 #1 idate() 示例

<?php
$timestamp
= strtotime('1st January 2004'); //1072915200

// 这将以两位数格式打印年份
// 然而,由于这将以“0”开头,因此
// 它只打印“4”
echo idate('y', $timestamp);
?>

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top