DateTime::modify

    date_modify

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

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

    描述

    面向对象风格

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

    过程式风格

    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，而不是警告。 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

    参见

    改进此页面

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

    用户贡献的备注 1 个备注

    4
    php_net at striderweb dot com
    3 个月前
    您需要对这里的变量小心一点。例如，如果您想添加一个可变数量的分钟，您可以使用 `->modify("+$min")。如果 `$min` 是一个负数，这将不起作用，因为 modify 会看到 "+" 并忽略 "-"。如果 `$min` 等于 -10，本例中的 modify 将添加 10 分钟，而不是减去！

    发生的事情是，如果 modify 字符串有两个操作，第一个操作将被执行，而随后的操作将被忽略。

    因此 "+-10 minutes" 将添加 10 分钟，即使您可能希望它添加负数。同样 "--10 minutes" 将减去 10 分钟，尽管看起来逻辑上应该是减去负数。
    ＋添加备注
    To Top