Метод addDays

Метод addDays класса Carbon применяется к объекту даты и добавляет к нему заданное количество дней. Первым параметром передаётся количество дней, которое нужно прибавить. Метод изменяет исходный объект и возвращает его же, что позволяет использовать цепочки вызовов. Если нужно вычесть дни, можно использовать метод subDays или передать отрицательное число в addDays.

Синтаксис

<?php
	use Carbon\Carbon;
	
	$date = Carbon::now()->addDays($days);
?>

Пример

Давайте получим дату через 5 дней от текущего момента:

<?php
	use Carbon\Carbon;
	
	$date = Carbon::now();
	$res = $date->addDays(5);
	
	echo $res->toDateString();
?>

Результат выполнения кода:

"2026-09-12"

Пример

Давайте прибавим 10 дней к конкретной дате:

<?php
	use Carbon\Carbon;
	
	$date = Carbon::create(2026, 9, 7, 0, 0, 0);
	$res = $date->addDays(10);
	
	echo $res->toDateString();
?>

Результат выполнения кода:

"2026-09-17"

Пример

Метод изменяет исходный объект, поэтому исходная дата также меняется:

<?php
	use Carbon\Carbon;
	
	$date = Carbon::now();
	$newDate = $date->addDays(3);
	
	echo $date->toDateString() . "\n";
	echo $newDate->toDateString();
?>

Результат выполнения кода:

"2026-09-10"
"2026-09-10"

Пример

Чтобы вычесть дни, передайте отрицательное число:

<?php
	use Carbon\Carbon;
	
	$date = Carbon::now();
	$res = $date->addDays(-7);
	
	echo $res->toDateString();
?>

Результат выполнения кода:

"2026-08-31"

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

метод subDays,
который вычитает дни из даты
метод format,
который форматирует дату по заданному шаблону
метод diffForHumans,
который возвращает разницу между датами в человекочитаемом формате
метод toDateString,
который преобразует дату в строку формата YYYY-MM-DD