Метод subDays

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

Синтаксис

<?php
	Carbon::now()->subDays($days);
?>

Пример

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

<?php
	use Carbon\Carbon;

	$currentDate = Carbon::now();
	$res = $currentDate->subDays(5);

	echo $res->toDateString();
?>

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

"2026-09-03"

Пример

Давайте вычтем 10 дней из конкретной даты:

<?php
	use Carbon\Carbon;

	$date = Carbon::create(2026, 9, 15, 0, 0, 0);
	$res = $date->subDays(10);

	echo $res->format('Y-m-d H:i:s');
?>

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

"2026-09-05 00:00:00"

Пример

Давайте используем метод для вычитания дней в цепочке с другими методами:

<?php
	use Carbon\Carbon;

	$res = Carbon::now()
		->subDays(7)
		->startOfDay()
		->format('Y-m-d H:i:s');

	echo $res;
?>

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

"2026-09-01 00:00:00"

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

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