DateTime::modify

date_modify

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

DateTime::modify -- date_modify — Изменяет метку времени

Описание

Объектно-ориентированный стиль

Процедурный стиль

Метод изменяет метку времени объекта DateTime путём добавления или вычитания времени в формате, который принимает метод DateTimeImmutable::__construct() .

Список параметров

object

Только для процедурного стиля: объект DateTime , который возвращает функция date_create() . Функция изменяет этот объект.

modifier

Строка даты и времени. Объяснение корректных форматов даёт раздел «Форматы даты и времени».

Возвращаемые значения

Метод возвращает новый экземпляр даты и времени DateTime , если выполнился успешно. Процедурный стиль возвращает false , если возникла ошибка.

Ошибки

Только для объектно-ориентированного API-интерфейса: метод выбрасывает исключение DateMalformedStringException , если передали строку с недопустимой датой и временем.

Список изменений

Примеры

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

2006年12月13日

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

2006年12月13日

<?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日

<?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

Смотрите также

• strtotime() - Преобразовывает текстовое представление даты на английском языке в метку времени Unix
• DateTimeImmutable::modify() - Создаёт новый объект с изменённой временной меткой
• DateTime::add() - Изменяет объект DateTime, добавляя количество дней, месяцев, лет, часов, минут и секунд
• DateTime::sub() - Вычитает дни, месяцы, годы, часы, минуты и секунды из объекта DateTime
• DateTime::setDate() - Устанавливает дату
• DateTime::setISODate() - Устанавливает дату в формате ISO
• DateTime::setTime() - Устанавливает время
• DateTime::setTimestamp() - Устанавливает дату и время на основе метки времени Unix