method public

Date::add()

Сигнатура

public add(string $interval) : $this

Описание

Каждый период длительности представляется целым числом, за которым следует обозначение периода. Если длительность содержит элементы времени, эта часть записи предваряется буквой T.
Обозначения периодов: Y — годы, M — месяцы, D — дни, W — недели, H — часы,
M — минуты, S — секунды.
Примеры: два дня — 2D, две секунды — T2S, шесть лет и пять минут — 6YT5M.
Единицы измерения должны указываться от самой крупной слева к самой мелкой справа.
Используйте символ "-" в начале для отрицательных периодов.
ИЛИ
Относительный период.
Примеры: "+5 weeks", "12 day", "-7 weekdays", '3 months - 5 days'

Параметры

$interval string

Добавляемый интервал времени.

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

$this

Как применяется в Date

Date::add() — метод класса \Bitrix\Main\Type\Date модуля «Главный модуль».

Метод объекта: сначала нужен экземпляр Date.

use Bitrix\Main\Type\Date;

/** @var Date $object */
$interval = '';
$result = $object->add($interval);
// $result: $this

Другие методы Date

__clone() Создаёт копию объекта.
__toString() Преобразует дату в строку с использованием формата по умолчанию из настроек культуры.
convertFormatToPhp() Преобразует формат даты из формата культуры в формат php.
createFromPhp() Создаёт объект Date из объекта PHP \DateTime.
createFromText() Создаёт объект Date из текста (возвращает массив результирующих объектов). Примеры: "end of next week",…
createFromTimestamp() Создаёт объект Date из Unix-метки времени.
format() Форматирует значение даты в строку.
getDiff() Возвращает разницу между датами.
getFormat() Возвращает формат даты из культуры в формате php.
getTimestamp() Возвращает Unix-метку времени из даты.
isCorrect() Проверяет строку на корректность даты (пытаясь создать объект Date).
setDate() Устанавливает текущую дату объекта DateTime на другую дату.

add() есть и у других классов модуля «Главный модуль»: AccessPermissionTable, AccessRoleRelationTable, AccessRoleTable, AddStrategy, ApplicationPasswordTable, CacheCleanPathTable, CacheTagTable, CacheTracker.

Исходный файл: source/main/lib/type/date.php:145