2024 日本 PHP 研討會

    DateTime::modify

    date_modify

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

    DateTime::modify -- date_modify — 修改時間戳記

    說明

    物件導向風格

    public DateTime::modify(字串 $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

    另請參閱

    發現問題了嗎？

    瞭解如何改進此頁面 • 提交 Pull Request • 回報錯誤
    ＋新增註解

    使用者貢獻的註解

    此頁面沒有使用者貢獻的註解。
    To Top