PHP Conference Japan 2024

    DateTime::modify

    date_modify

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

    DateTime::modify -- date_modify — 更改时间戳

    描述

    面向对象风格

    public DateTime::modify(string $modifier): DateTime

    过程化风格

    date_modify(DateTime $object, string $modifier): DateTime|false

    通过以 DateTimeImmutable::__construct() 接受的格式递增或递减来更改 DateTime 对象的时间戳。

    参数

    object

    仅过程化风格：由 date_create() 返回的 DateTime 对象。该函数修改此对象。

    modifier

    日期/时间字符串。有效格式在 日期和时间格式 中解释。

    返回值

    成功时返回 DateTime。过程化风格在失败时返回 false。

    错误/异常

    仅面向对象 API：如果传递了无效的日期/时间字符串，则会抛出 DateMalformedStringException。

    变更日志

    版本 描述
    8.3.0 DateTime::modify() 现在如果传递了无效字符串，则会抛出 DateMalformedStringException。以前，它返回 false，并发出警告。date_modify() 未更改。

    范例

    示例 #1 DateTime::modify() 示例

    面向对象风格

    <?php
    $date     = new DateTime('2006-12-12');
    $date->modify('+1 day');
    echo     $date->format('Y-m-d');
    ?>

    过程化风格

    <?php
    $date     = date_create('2006-12-12');
    date_modify($date, '+1 day');
    echo     date_format($date, 'Y-m-d');
    ?>

    以上示例将输出

    2006-12-13

    示例 #2 添加或减去月份时请注意

    <?php
    $date     = new DateTime('2000-12-31');

    $date->modify('+1 month');
    echo     $date->format('Y-m-d') . "\n";

    $date->modify('+1 month');
    echo     $date->format('Y-m-d') . "\n";
    ?>

    以上示例将输出

    2001-01-31
2001-03-03

    示例 #3 支持所有日期和时间的格式

    <?php
    $date     = new DateTime('2020-12-31');

    $date->modify('July 1st, 2023');
    echo     $date->format('Y-m-d H:i') . "\n";

    $date->modify('Monday next week');
    echo     $date->format('Y-m-d H:i') . "\n";

    $date->modify('17:30');
    echo     $date->format('Y-m-d H:i') . "\n";
    ?>

    以上示例将输出

    2023-07-01 00:00
2023-07-03 00:00
2023-07-03 17:30

    参见

    发现问题？

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

    用户贡献的笔记

    此页面没有用户贡献的笔记。
    To Top