DateTimeImmutable::modify
(PHP 5 >= 5.5.0, PHP 7)
DateTimeImmutable::modify — Создает новый объект с измененной временной меткой
Описание
Создает новый объект DateTimeImmutable с измененной временной меткой. Первоначальный объект не изменяется.
Список параметров
-
object -
Только для процедурного стиля: Объект DateTime, возвращаемый date_create(). Функция изменяет этот объект.
-
modify -
Строка даты/времени. Объяснение корректных форматов дано в Форматы даты и времени.
Возвращаемые значения
Возвращает новый объект или FALSE в случае возникновения ошибки.
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения для работы с датой и временем
- Дата и Время
- Функция DateTimeImmutable::add() - Добавляет указанное количество дней, месяцев, лет, часов, минут и секунд.
- Функция DateTimeImmutable::__construct() - Возвращает новый объект DateTimeImmutable
- Функция DateTimeImmutable::createFromFormat() - Возвращает новый объект DateTimeImmutable, отформатированный согласно переданному формату
- DateTimeImmutable::createFromMutable
- Функция DateTimeImmutable::getLastErrors() - Возвращает предупреждения и ошибки
- Функция DateTimeImmutable::modify() - Изменяет временную метку
- Функция DateTimeImmutable::__set_state() - Обработчик __set_state
- Функция DateTimeImmutable::setDate() - Устанавливает дату
- Функция DateTimeImmutable::setISODate() - Устанавливает дату в формате ISO
- Функция DateTimeImmutable::setTime() - Устанавливает время
- Функция DateTimeImmutable::setTimestamp() - Устанавливает дату и время по переданной временной метке Unix
- Функция DateTimeImmutable::setTimezone() - Устанавливает временную зону
- Функция DateTimeImmutable::sub() - Вычитает переданное количество дней, месяцев, лет, часов, минут и секунд
Коментарии
To modify milliseconds and microseconds use next formats:
<?php
$a = new DateTimeImmutable('2018-01-01 00:00:00.000');
$b = $a->modify('9 msec');
var_dump($b->format('Y-m-d H:i:s.u'));
?>
Returns string(26) "2018-01-01 00:00:00.009000"
<?php
$a = new DateTimeImmutable('2018-01-01 00:00:00.000');
$b = $a->modify('9 usec');
var_dump($b->format('Y-m-d H:i:s.u'));
?>
Returns "2018-01-01 00:00:00.000009"