PHP Conference Japan 2024

idate

(PHP 5, PHP 7, PHP 8)

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

描述

idate(字符串 $format, ?整数 $timestamp = null): 整数|false

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

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

参数

format

format 参数字符串中识别以下字符
format 字符 描述
B Swatch Beat/互联网时间
d 月份中的日期
h 小时(12 小时格式)
H 小时(24 小时格式)
i 分钟
I (大写 i) 如果启用了夏令时,则返回 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 参数是一个 整数 Unix 时间戳,如果省略 timestamp 或为 null,则默认为当前本地时间。换句话说,它默认为 time() 的值。

返回值

成功时返回一个 整数,失败时返回 false

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

错误/异常

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

变更日志

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

示例

示例 #1 idate() 示例

<?php
$timestamp
= strtotime('2004 年 1 月 1 日'); //1072915200

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

参见

添加注释

用户贡献的注释

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