Метод toDateString

Метод toDateString применяется к объекту Carbon и возвращает строковое представление даты в формате год-месяц-день. Первым и единственным параметром передается экземпляр класса Carbon. Результатом работы метода является строка формата Y-m-d.

Синтаксис

<?php
	Carbon::parse($date)->toDateString();
?>

Пример

Давайте преобразуем текущую дату в строку:

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

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

"2026-09-08"

Пример

Давайте преобразуем конкретную дату в строку:

<?php
	use Carbon\Carbon;
	
	$date = Carbon::parse('2025-12-31 15:30:45');
	$res = $date->toDateString();
	
	echo $res;
?>

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

"2025-12-31"

Пример

Давайте используем метод в модели Eloquent для форматирования даты:

<?php
	namespace App\Models;
	
	use Illuminate\Database\Eloquent\Model;
	use Carbon\Carbon;
	
	class Article extends Model
	{
		protected $fillable = [
			'title',
			'text',
			'published_at'
		];
		
		public function getFormattedDateAttribute()
		{
			if ($this->published_at) {
				return Carbon::parse($this->published_at)->toDateString();
			}
			
			return null;
		}
	}
?>

<?php
	use App\Models\Article;
	use Carbon\Carbon;
	
	Route::get('/articles', function () {
		$articles = Article::all();
		
		foreach ($articles as $article) {
			echo $article->title . ' - ' . $article->formatted_date . "\n";
		}
	});
?>

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

"Article 1 - 2026-09-01"
"Article 2 - 2026-09-02"
"Article 3 - 2026-09-03"

Пример

Давайте выполним сравнение с другими методами форматирования:

<?php
	use Carbon\Carbon;
	
	$date = Carbon::parse('2025-12-31 15:30:45');
	
	echo $date->toDateString() . "\n";
	echo $date->toDateTimeString() . "\n";
	echo $date->format('d.m.Y H:i') . "\n";
?>

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

"2025-12-31"
"2025-12-31 15:30:45"
"31.12.2025 15:30"

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

метод toDateTimeString,
который преобразует дату в строку с временем
метод format,
который форматирует дату по заданному шаблону
метод diffForHumans,
который возвращает человекочитаемую разницу между датами
метод isToday,
который проверяет, является ли дата сегодняшним днем