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 string
DATE_ATOM: Atom (例如：2005-08-15T15:52:01+00:00)
DateTimeInterface::COOKIE string
DATE_COOKIE: HTTP Cookie (例如：Monday, 15-Aug-2005 15:52:01 UTC)
DateTimeInterface::ISO8601 string
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 string
DATE_ISO8601_EXPANDED: 扩展的 ISO-8601 (例如：+10191-07-26T08:59:52+01:00)
注意: 此格式允许年份范围超出 ISO-8601 的正常范围 0000-9999，方法是始终包含一个符号字符。它还解决了时区部分 (+01:00) 与 ISO-8601 兼容的问题。
DateTimeInterface::RFC822 string
DATE_RFC822: RFC 822 (例如：Mon, 15 Aug 05 15:52:01 +0000)
DateTimeInterface::RFC850 string
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.4.0	类常量现在已类型化。
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 ¶

2 年前

请注意，如果您使用 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);
?>