DateTimeInterface 接口

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

简介

DateTimeInterface 的创建是为了让参数、返回值或属性类型声明能够接受 DateTimeImmutable 或 DateTime 作为值。无法使用用户空间类实现此接口。

允许通过 DateTimeImmutable::format() 和 DateTime::format() 格式化 DateTimeImmutable 或 DateTime 对象的常用常量也在此接口上定义。

接口概要

interface DateTimeInterface {

/* 常量 */

public const string ATOM = "Y-m-d\\TH:i:sP";

public const string COOKIE = "l, d-M-Y H:i:s T";

public const string ISO8601 = "Y-m-d\\TH:i:sO";

public const string ISO8601_EXPANDED = "X-m-d\\TH:i:sP";

public const string RFC822 = "D, d M y H:i:s O";

public const string RFC850 = "l, d-M-y H:i:s T";

public const string RFC1036 = "D, d M y H:i:s O";

public const string RFC1123 = "D, d M Y H:i:s O";

public const string RFC7231 = "D, d M Y H:i:s \\G\\M\\T";

public const string RFC2822 = "D, d M Y H:i:s O";

public const string RFC3339 = "Y-m-d\\TH:i:sP";

public const string RFC3339_EXTENDED = "Y-m-d\\TH:i:s.vP";

public const string RSS = "D, d M Y H:i:s O";

public const string W3C = "Y-m-d\\TH:i:sP";

/* 方法 */

public diff(DateTimeInterface $targetObject, bool $absolute = false): DateInterval

public format(string $format): string

public getOffset(): int

public getTimestamp(): int

public getTimezone(): DateTimeZone|false

public __wakeup(): void

}

预定义常量

DateTimeInterface::ATOM
DATE_ATOM: Atom（示例：2005-08-15T15:52:01+00:00）
DateTimeInterface::COOKIE
DATE_COOKIE: HTTP Cookie（示例：Monday, 15-Aug-2005 15:52:01 UTC）
DateTimeInterface::ISO8601
DATE_ISO8601: ISO-8601（示例：2005-08-15T15:52:01+0000）
注意: 此格式与 ISO-8601 不兼容，但出于向后兼容性的原因保留了此格式。使用 DateTimeInterface::ISO8601_EXPANDED、DateTimeInterface::ATOM 来代替 ISO-8601 的兼容性。（参考 ISO8601:2004 第 4.3.3 节 d 条款）
DateTimeInterface::ISO8601_EXPANDED
DATE_ISO8601_EXPANDED: ISO-8601 扩展（示例：+10191-07-26T08:59:52+01:00）
注意: 此格式允许年份范围超出 ISO-8601 正常范围 0000-9999，方法是始终包含一个符号字符。它还解决了时区部分 (+01:00) 与 ISO-8601 兼容的问题。
DateTimeInterface::RFC822
DATE_RFC822: RFC 822（示例：Mon, 15 Aug 05 15:52:01 +0000）
DateTimeInterface::RFC850
DATE_RFC850: RFC 850（示例：Monday, 15-Aug-05 15:52:01 UTC）
DateTimeInterface::RFC1036
DATE_RFC1036: RFC 1036（示例：Mon, 15 Aug 05 15:52:01 +0000）
DateTimeInterface::RFC1123
DATE_RFC1123: RFC 1123（示例：Mon, 15 Aug 2005 15:52:01 +0000）
DateTimeInterface::RFC7231
DATE_RFC7231: RFC 7231（自 PHP 7.0.19 和 7.1.5 起）（示例：Sat, 30 Apr 2016 17:52:13 GMT）
DateTimeInterface::RFC2822
DATE_RFC2822: RFC 2822（示例：Mon, 15 Aug 2005 15:52:01 +0000）
DateTimeInterface::RFC3339
DATE_RFC3339: 与 DATE_ATOM 相同
DateTimeInterface::RFC3339_EXTENDED
DATE_RFC3339_EXTENDED: RFC 3339 扩展格式（示例：2005-08-15T15:52:01.000+00:00）
DateTimeInterface::RSS
DATE_RSS: RSS（示例：Mon, 15 Aug 2005 15:52:01 +0000）
DateTimeInterface::W3C
DATE_W3C: 万维网联盟（示例：2005-08-15T15:52:01+00:00）

变更日志

版本	描述
8.2.0	添加了常量 `DateTimeInterface::ISO8601_EXPANDED`。
7.2.0	DateTime 的类常量现在在 DateTimeInterface 上定义。

DateTimeInterface::diff — 返回两个 DateTime 对象之间的差值
DateTimeInterface::format — 返回根据给定格式格式化的日期
DateTimeInterface::getOffset — 返回时区偏移量
DateTimeInterface::getTimestamp — 获取 Unix 时间戳
DateTimeInterface::getTimezone — 返回相对于给定 DateTime 的时区
DateTime::__wakeup — __wakeup 处理程序

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 1 个注释

上

下

bohwaz ¶

1 年前

请注意，如果您使用 DATE_RFC7231 格式（用于 HTTP/1.1），您需要在 *之前* 将 DateTime 对象时区更改为 GMT，否则您会遇到奇怪的结果，因为此格式 *不会* 将日期转换为 GMT。

因此，如果您有一个使用 UTC+01:00 作为时区的 DateTime 对象，您将发现生成日期字符串与“正确”日期之间存在 1 小时的差异。

推荐用法

<?php
$date_gmt = clone $date;
$date_gmt->setTimezone(new \DateTimeZone('GMT'));
echo $date_gmt->format(DATE_RFC7231);
?>