Как исправить синтаксис запроса даты в Rails: SQL error

Быстрый ответ

Для отбора записей, созданных после заданной даты, в Rails применяется метод where с условием даты, большей заданной:

# Ищем записи в Post с датой 'published_at', превышающей 1 января 2023 года.
Post.where("published_at > ?", Date.new(2023,1,1))

Часовые пояса для точной работы с датами

Работая с датами, используйте Time.zone.now вместо DateTime.now, чтобы учесть настройки часового пояса в приложении Rails:

# Отбираем будущие события. Звоним в будущее на Марс.
Event.where("start_time > ?", Time.zone.now)

Диапазоны дат

Используйте синтаксис диапазонов Ruby для выборки записей за определенный период:

# Выбираем пользователей, зарегистрировавшихся в последние 3 дня.
User.where(created_at: 3.days.ago..Time.zone.now)

Также возможно формировать запрос с неограниченным концом, указав только начальную дату:

# Ищем продукты, дата выпуска которых начинается с 2023 года.
Product.where("released_at >= ?", Date.new(2023,1,1)...)

Сравнение дат с учетом включения заданной даты

Если необходимо включить в сравнение заданную дату, используйте >= вместо >:

# Отбираем фильмы, премьера которых сегодня.
Movie.where("release_date >= ?", Time.zone.today)

Убедитесь, что SQL-синтаксис верен, чтобы избежать возможных уязвимостей:

# Неправильно: пробел перед вопросительным знаком вызывает ошибку!
User.where("signup > ? ", Date.today)

# Правильно: безопасный запрос без пробелов в условии.
User.where("signup > ?", Date.today)

Визуализация

В качестве образа возьмем поезд календаря (🚂), где каждый вагон – это день месяца:

Календарный Поезд (🚂): [📆 1 июля], [📆 2 июля], [📆 3 июля], ... [📆 15 июля]

Давайте посмотрим, как Rails отбирает даты после 10 июля:

# 'Поезд, отправляющийся после 10 июля', скоро отправится. Поспешите купить билеты!
Train.where('departure_date > ?', Date.new(2023, 7, 10))

Даты, отобранные в результате запроса:

Результат запроса: ... [📆 11 июля], [📆 12 июля], [📆 13 июля], [📆 15 июля]

Реальные примеры (результаты могут отличаться)

Борьба с монстрами часовых поясов

Для приложений, работающих в разных часовых поясах, храните время в формате UTC и конвертируйте его в местное время при отображении:

# Соблюдение времени встреч – это вопрос вежливости.
Meeting.where("start_time > ?", Time.now.utc)

Подробнее об этом расскажет наш спикер на видео

Правильное использование TimeWithZone

Чтобы получить актуальное время в часовом поясе игрового окружения:

# Вопрос о времени в Нарнии остается открытым.
Schedule.where("start_time > ?", Time.zone.now)

Преимущества свежих версий Rails

Начиная с Rails 5.1, использование именованных заполнителей делает код более понятным и удобным для поддержки:

# Давайте эффективнее использовать свое время – вот статьи, опубликованные только вчера.
Article.where("published_at > :date", date: Date.yesterday)

Ограничения и решения

Время перехода на летний режим

Если переход на летнее время вызывает проблемы в вашем приложении, воспользуйтесь возможностями Rails:

# Эффективная защита от капризов летнего перевода времени.
Event.where("start_time > ?", Time.zone.now.beginning_of_day)

Предсказуемость работы с базами данных и часовыми поясами.

Помните, что часовой пояс базы данных может отличаться от часового пояса Rails. Используйте для этого атрибуты времени с учетом часового пояса:

# Безопасность и точность – ваши проверки времени всегда на страже.
Appointment.where("start_time > ?", Time.zone.now)

Соблюдение консистентности при работе с часовыми поясами

При работе важно одинаково использовать часовые пояса. Сочетание Time.zone.now и DateTime.now может привести к непредсказуемым результатам, ведь пицца с ананасами не всем по вкусу.

Полезные материалы

1. Интерфейс запросов Active Record — Руководства Ruby on Rails
2. Новые вопросы 'ruby-on-rails+date' – Stack Overflow
3. where (ActiveRecord::QueryMethods) – APIdock
4. ActiveSupport::TimeWithZone
5. #202 Запросы Active Record в Rails 3 – RailsCasts
6. Когда следует использовать DateTime, а когда Time? · GitHub
7. Примеры SQL-инъекций в Rails