DateTime 类

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

简介

日期和时间的表示。

此类与 DateTimeImmutable 行为相同，只是当调用修改方法（如 DateTime::modify()）时，对象本身会发生修改。

警告

调用 DateTime 类对象的方法将更改封装在这些对象中的信息，如果您想阻止这种情况，您将必须使用 clone 运算符来创建一个新对象。使用 DateTimeImmutable 而不是 DateTime 以默认情况下获得此推荐的行为。

类概要

class DateTime implements DateTimeInterface {

/* 继承的常量 */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

/* 方法 */

public __construct(string $datetime = "now", ?DateTimeZone $timezone = null)

public add(DateInterval $interval): DateTime

public static createFromFormat(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTime|false

public static createFromImmutable(DateTimeImmutable $object): static

public static createFromInterface(DateTimeInterface $object): DateTime

public modify(string $modifier): DateTime|false

public static __set_state(array $array): DateTime

public setDate(int $year, int $month, int $day): DateTime

public setISODate(int $year, int $week, int $dayOfWeek = 1): DateTime

public setTime(
    int $hour,
    int $minute,
    int $second = 0,
    int $microsecond = 0
): DateTime

public setTimestamp(int $timestamp): DateTime

public setTimezone(DateTimeZone $timezone): DateTime

public sub(DateInterval $interval): DateTime

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

}

变更日志

版本	描述
7.2.0	DateTime 的类常量现在在 DateTimeInterface 上定义。
7.1.0	DateTime 构造函数现在在构造的值中包含当前微秒。在此之前，它总是将微秒初始化为 `0`。

DateTime::add — 修改 DateTime 对象，添加天数、月数、年数、小时数、分钟数和秒数
DateTime::__construct — 返回新的 DateTime 对象
DateTime::createFromFormat — 根据指定格式解析时间字符串
DateTime::createFromImmutable — 返回包含给定 DateTimeImmutable 对象的新 DateTime 实例
DateTime::createFromInterface — 返回包含给定 DateTimeInterface 对象的新 DateTime 对象
DateTime::getLastErrors — DateTimeImmutable::getLastErrors 的别名
DateTime::modify — 更改时间戳
DateTime::__set_state — __set_state 处理程序
DateTime::setDate — 设置日期
DateTime::setISODate — 设置 ISO 日期
DateTime::setTime — 设置时间
DateTime::setTimestamp — 根据 Unix 时间戳设置日期和时间
DateTime::setTimezone — 设置 DateTime 对象的时间区域
DateTime::sub — 从 DateTime 对象中减去天数、月数、年数、小时数、分钟数和秒数

改进此页面

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

＋添加注释

用户贡献的注释

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

DateTime 类

简介

类概要

变更日志

目录

改进此页面

用户贡献的注释