Функция today
Функция today возвращает объект Carbon, представляющий текущую дату с временем, установленным на начало дня (00:00:00). Это удобно для сравнения дат без учёта времени, создания запросов с фильтрацией по дате или формирования отчётов за текущий день. Функция учитывает часовой пояс, установленный в конфигурации приложения.
Синтаксис
<?php
$date = today();
?>
Пример использования без параметров
Получение текущей даты в начале дня:
<?php
$date = today();
echo $date->toDateString();
?>
Результат выполнения кода (текущая дата):
"2026-09-08"
Пример с указанием часового пояса
Функция today принимает необязательный параметр - название часового пояса:
<?php
$dateMoscow = today('Europe/Moscow');
$dateNewYork = today('America/New_York');
echo $dateMoscow->toDateString();
echo $dateNewYork->toDateString();
?>
Результат выполнения кода может отличаться в зависимости от текущей даты:
"2026-09-08"
"2026-09-08"
Пример использования в запросах Eloquent
Фильтрация записей, созданных сегодня:
<?php
namespace App\Http\Controllers;
use App\Models\Article;
class ArticleController extends Controller
{
public function index()
{
$today = today();
$articles = Article::whereDate('created_at', $today)->get();
foreach ($articles as $article) {
echo $article->title;
}
}
}
?>
Пример с форматированием даты
Использование методов Carbon для форматирования даты:
<?php
$today = today();
echo $today->format('d.m.Y');
echo $today->format('l, F j, Y');
?>
Результат выполнения кода:
"08.09.2026"
"Tuesday, September 8, 2026"
Пример проверки, является ли дата сегодняшней
Сравнение произвольной даты с сегодняшним днём:
<?php
use Carbon\Carbon;
$date = Carbon::parse('2026-09-07');
$today = today();
if ($date->isToday()) {
echo "Date is today";
} else {
echo "Date is not today";
}
?>
Результат выполнения кода:
"Date is not today"
