如何在ActiveAdmin中实现当日date_range过滤并保留输入值

问题场景 #

Sale与Receipt为1:1关联，Sale通过方法委托实现receipt_date调用关联收据的日期字段。在ActiveAdmin的Sale列表页添加date_range类型的receipt_date过滤器后：

• 起止日期间隔≥1天时过滤正常
• 当日过滤（起止日期相同）时，因默认查询条件为receipts.date >= 当天 AND receipts.date <= 当天，若receipts.date为datetime类型，仅会匹配当天0点整的记录，导致无结果
• 曾尝试通过自定义receipt_date_gteq/receipt_date_lteq方法（将lteq查询日期加1天）解决当日过滤问题，但过滤器输入框的「From」「To」值无法回显，仅URL和搜索状态框可见，影响逐步筛选的操作效率

正确实现方案 #

方式一：自定义ActiveAdmin过滤器逻辑（推荐） #

在ActiveAdmin配置中直接处理日期范围的查询逻辑，既解决当日过滤问题，又保留输入值回显：

# app/admin/sales.rb
ActiveAdmin.register Sale do
  filter :receipt_date_range, as: :date_range, label: "收据日期" do |date_range|
    start_date = date_range.start
    end_date = date_range.end

    if start_date && end_date && start_date == end_date
      # 当日过滤：匹配当天全天的记录
      joins(:receipt).where(receipts: { date: start_date.beginning_of_day..end_date.end_of_day })
    else
      # 跨天过滤：正常范围匹配
      query = joins(:receipt)
      query = query.where("receipts.date >= ?", start_date.beginning_of_day) if start_date
      query = query.where("receipts.date <= ?", end_date.end_of_day) if end_date
      query
    end
  end
end

# app/models/sale.rb
class Sale < ApplicationRecord
  belongs_to :receipt
  # 委托获取收据日期
  delegate :date, to: :receipt, prefix: true, allow_nil: true
end

方式二：全局自定义Ransack Predicate（复用场景） #

如果多个模型需要类似的当日过滤逻辑，可定义全局Ransack predicate：

# config/initializers/ransack.rb
Ransack.configure do |config|
  config.add_predicate :lteq_end_of_day,
    arel_predicate: :lteq,
    formatter: proc { |date| date.to_date.end_of_day },
    type: :date
end

# app/models/sale.rb
class Sale < ApplicationRecord
  belongs_to :receipt
  delegate :date, to: :receipt, prefix: true, allow_nil: true

  # 暴露receipt.date为Ransack可查询字段
  ransacker :receipt_date do
    Arel.sql("DATE(receipts.date)")
  end
end

# app/admin/sales.rb
ActiveAdmin.register Sale do
  filter :receipt_date_gteq, as: :date, label: "收据日期（从）"
  filter :receipt_date_lteq_end_of_day, as: :date, label: "收据日期（到）"
end

原方案回显失败原因 #

之前自定义的receipt_date_gteq/receipt_date_lteq方法直接返回查询语句，绕过了Ransack的参数解析与表单映射机制，导致Ransack无法将URL中的日期值回填到过滤器输入框中。上述两种方案均基于Ransack原生机制处理参数，因此能保证输入值正常回显。

内容的提问来源于stack exchange，提问作者Jonathon Nordquist